About crypto-price-mcp
crypto-price-mcp is an MCP server that gives AI agents live prices and recent candles for 200+ cryptocurrencies. It provides market data only, with no trading advice or order placement.
Key features
- 01Get a coin's current price
- 02Fetch prices for multiple coins
- 03List available symbols
- 04Retrieve recent OHLCV candles
Use cases
- 01Answer queries about current BTC or other coin prices
- 02Review price movement and volume over a chosen interval
- 03Find which symbols have available market data
MCP support
The MCP server exposes tools for current prices, batch price lookups, symbol listings, and recent OHLCV history.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMEprice-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")andget_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
| 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 (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
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.