English Français العربية

io.github.wesseltl/price-data-mcp

Official registry Finance and payments

Live market prices and candles for AI agents (200+ coins). Data only, no trading advice.

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

PYPI package hyperliquid-price-mcp
Claude Code 
claude mcp add price-data-mcp -- uvx hyperliquid-price-mcp==0.1.3
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "price-data-mcp": {
            "command": "uvx",
            "args": [
                "hyperliquid-price-mcp==0.1.3"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. price-data-mcp
  2. What your agent can do with it
  3. Quickstart
  4. The tools
  5. Also usable from plain Python
  6. How it works
  7. Tests
  8. Scope
  9. License

price-data-mcp

Give your AI agent live market prices. An MCP server that lets an agent look up the current price, the full symbol list, and recent price history for 200+ coins.

An LLM's knowledge is frozen at training time, so it can't answer "what's BTC trading at right now?". This closes that gap. It returns market data only. It never gives a trading signal or predicts direction.

What your agent can do with it

You: What's Bitcoin trading at, and how has it moved over the last few hours?

Agent (calls get_price("BTC") and get_candles("BTC", "1h", 6)): Bitcoin is at $65,047. Over the last 6 hours it's held between $65,020 and $65,132 on rising volume.

The agent fetches real numbers instead of guessing from stale training data.

Quickstart

pip install "hyperliquid-price-mcp[mcp]"

Add it to your MCP client (e.g. Claude Desktop's config):

{
  "mcpServers": {
    "market-prices": { "command": "hyperliquid-price-mcp" }
  }
}

Restart your client. The agent now has four tools.

The tools

ToolReturns
get_price("BTC"){"symbol": "BTC", "price": 65047.5, "as_of": 1786204330859}
get_prices(["BTC","ETH"])current price for each, missing ones flagged
list_symbols()every symbol it can price (200+)
get_candles("BTC","1h",100)recent OHLCV history (1m … 1d)

Example candle:

{"open_ms": 1786201200000, "open": 65104.0, "high": 65132.0,
 "low": 65020.0, "close": 65047.0, "volume": 409.43, "trades": 7014}

Also usable from plain Python

from price_data_mcp import prices

prices.get_price("BTC")                # {'symbol': 'BTC', 'price': 65047.5, 'as_of': ...}
prices.get_candles("ETH", "1h", 24)    # last 24 hourly candles
prices.list_symbols()                  # ['AAVE', 'ADA', 'APE', ...]

How it works

Prices come from the public Hyperliquid info API. The core fetching module (price_data_mcp/prices.py) uses the Python standard library only (no dependencies), so it's small and easy to audit. The mcp extra is only needed to run the server.

Tests

python -m unittest discover -s tests     # network is mocked, runs fully offline

Scope

A market-data source for agents. It reports prices and history. It does not give trading signals, predict where the price is going, or place orders.

License

MIT

Frequently asked questions

What is io.github.wesseltl/price-data-mcp?

Live market prices and candles for AI agents (200+ coins). Data only, no trading advice.

How do I install io.github.wesseltl/price-data-mcp?

It runs on your machine. In Claude Code: claude mcp add price-data-mcp -- uvx hyperliquid-price-mcp==0.1.3. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.wesseltl/price-data-mcp need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.wesseltl/price-data-mcp open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.wesseltl/price-data-mcp?

It is published by wesseltl. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.