Skip to main content
Glama
wesseltl

crypto-price-mcp

by wesseltl

price-data-mcp

PyPI Python MCP License Deps

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.

Related MCP server: GearTrade MCP Server

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

Tool

Returns

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 (1m1d)

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

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    Not graded
    maintenance
    Enables interaction with the Hyperliquid DEX for retrieving market data, managing positions, and executing trades. Supports both testnet and mainnet operations with comprehensive trading tools including order placement, cancellation, and portfolio management.
    11
    MIT
  • A
    license
    Not graded
    quality
    C
    maintenance
    Enables AI assistants to perform cryptocurrency trading analysis and execution with 38+ tools including real-time market data, technical indicators, risk management, and support for both paper trading and live execution on Hyperliquid.
    7
    MIT
  • A
    license
    A
    quality
    D
    maintenance
    Enables AI agents to interact with Hyperliquid perpetual futures exchange for market analysis, account management, and risk-managed trading.
    5
    1
    MIT
  • A
    license
    A
    quality
    B
    maintenance
    Read-only Hyperliquid and cross-exchange market research for AI agents, providing structured tools for live market data without requiring authentication.
    9
    35 npm
    MIT