How do I use Crypto Price MCP Server?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Crypto Price MCP Server what's the current price of Bitcoin?" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

Crypto Price MCP Server

by ceeyang-ai

Overview Schema Source Related Servers Discussions Admin

Python

Remote

Crypto Price MCP Server 💰📊

Python License Stars MCP GitHub

A Model Context Protocol (MCP) server for real-time cryptocurrency price data — prices, market data, trending coins, historical charts, and currency conversion. Powered by the free CoinGecko API — no API key required.

Built for AI agents. Works with Hermes Agent, Claude Code, Cursor, Windsurf, and any MCP-compatible client.

✨ Features (9 Tools)

💵 Price & Conversion (2 Tools)

Tool	Description
`get_price`	Current price of any crypto in any currency (USD, EUR, JPY, BTC, etc.)
`convert_currency`	Convert an amount of one crypto to another currency in real time

📊 Market Data (2 Tools)

Tool	Description
`get_market_data`	Full market snapshot: rank, market cap, supply, ATH, 24h/7d/30d change
`get_global_stats`	Overall crypto market: total cap ($2.25T+), 24h volume, BTC/ETH dominance

🔥 Discovery (3 Tools)

Tool	Description
`get_trending`	Top 15 trending coins on CoinGecko right now
`get_top_gainers`	Top gainers/losers in the last 24 hours
`search_coins`	Search coins by name or symbol

📈 Historical (1 Tool)

Tool	Description
`get_historical_prices`	Historical daily OHLC prices (1d, 7d, 30d, 90d, 365d, max)

ℹ️ Info (1 Tool)

Tool	Description
`get_coin_info`	Detailed coin info: description, links, categories, genesis date

Related MCP server: mcp-coincap-jj

🚀 Quick Start

Install

# From GitHub
pip install git+https://github.com/ceeyang-ai/crypto-price-mcp-server.git

Run

# Start as MCP server (stdio mode)
crypto-price-mcp-server

🔌 Usage with AI Agents

Hermes Agent

Add to ~/.hermes/config.yaml:

mcp_servers:
  crypto-price:
    command: "crypto-price-mcp-server"

Restart → use mcp_crypto_price_get_price, mcp_crypto_price_get_trending, etc.

Claude Code / Cursor / Any MCP Client

Add to your MCP config:

{
  "mcpServers": {
    "crypto-price": {
      "command": "crypto-price-mcp-server"
    }
  }
}

📖 Examples

Check Bitcoin Price

get_price(coin_id="bitcoin", vs_currency="usd")

Returns:

**BITCOIN** (USD)
• Price: 62,807

get_trending()

Returns top 15 trending coins with rank, BTC price, and score.

Full Market Analysis

get_market_data(coin_id="solana", vs_currency="usd")

Returns rank, price, market cap, volume, supply, ATH, 24h/7d/30d change percentages.

Historical Data

get_historical_prices(coin_id="bitcoin", vs_currency="usd", days=7)

Returns open, close, high, low, change percentage, and recent data points.

Convert Crypto

convert_currency(coin_id="bitcoin", amount=0.5, vs_currency="usd")

Returns:

💱 **0.5 BITCOIN** = **31,417.50 USD**
   Rate: 1 BITCOIN = 62,835 USD

🛠 Requirements

Python 3.10+
mcp ≥ 1.0
httpx ≥ 0.27
Internet access (CoinGecko API)
No API key required (uses free public CoinGecko API)

🌐 API Dependencies

This server uses the CoinGecko free API:

Rate limit: ~30 calls/minute (free tier)
No registration needed — works out of the box
No API key required for public endpoints

If you need higher rate limits, consider using a CoinGecko API key with the x_cg_demo_api_key header (modify the _request function in __init__.py).

📦 Project Structure

crypto-price-mcp-server/
├── src/crypto_price_mcp_server/
│   └── __init__.py        # All 9 tools + CoinGecko API client
├── pyproject.toml          # Build config (setuptools)
├── README.md
└── LICENSE (MIT)

👨‍💻 Development

git clone https://github.com/ceeyang-ai/crypto-price-mcp-server.git
cd crypto-price-mcp-server
pip install -e .
python -c "from crypto_price_mcp_server import get_price; print(get_price('bitcoin'))"

Running Tests

python tests/test_server.py

Tests hit the real CoinGecko API — be mindful of the 30 calls/min rate limit.

📄 License

MIT — free for personal and commercial use.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive

ResponsivenessNo issues

Resources

GitHub Repository

Need Help?

Related Servers

Related MCP Connectors

Coingecko A
io.github.pipeworx-io
CoinGecko MCP — wraps CoinGecko free API (no auth required)
Cryptocurrency Finance
2
AIsa Crypto Market Data AOAuth
one.aisa
Your agent needs crypto prices it can rely on — spot, ranked market tables, history, OHLC, per-venue tickers, and what is trending right now. **What you can ask for** • "What is the price of these 20 tokens in USD and EUR right now?" • "Give me the top 100 by market cap with 24h and 7d change." • "Chart this coin's price over the last year, hourly." • "Where does this token trade, and at what spread per venue?" • "What is trending on CoinGecko today?" **How to use it** Point any MCP client at https://mcp.aisa.one/crypto-market-data/mcp and sign in with OAuth — there is no key to create or paste. 21 CoinGecko tools: simple price and token price by contract, supported currencies, coin list and detail, ranked markets, history, market charts and ranges, OHLC, per-coin tickers, categories, exchanges and their tickers, token data and charts, and trending. **It is also a door to the rest** The same login reaches 26 sources and 580+ operations. Price the token here, then ask the same agent what X is posting about it — without adding a second server. **What it costs** Finding and inspecting an operation is free. Running one is billed per call at API prices, with no seat and no monthly minimum, and every call takes max_price_usd so an agent cannot overspend by accident. **Where else it reaches** https://mcp.aisa.one/finance/mcp for equities, crypto and prediction markets in one place.
Cryptocurrency Finance
261
Crypto Price MCP A
io.github.Lulu-The-Narwhal
Free, keyless live cryptocurrency prices, market cap, and 24h change via CoinGecko.
Cryptocurrency Finance
11
Crypto Prices A
io.github.guptaprakhariitr
Live and historical cryptocurrency prices via CoinGecko free API.
Cryptocurrency Finance
52

Related MCP Servers

Crypto Price & Market Analysis
Cryptocurrency Finance
truss44
A
license
B
quality
A
maintenance
A Model Context Protocol (MCP) server that provides comprehensive cryptocurrency analysis using the CoinCap API. This server offers real-time price data, market analysis, and historical trends through an easy-to-use interface.
Updated 4 days ago (2026-10-06 20:21 UTC)
3
469 npm
39
MIT
mcp-coincap-jj
Cryptocurrency Data Platforms Finance
wazzan
A
license
A
quality
B
maintenance
A Model Context Protocol (MCP) server that provides comprehensive cryptocurrency analysis using the CoinCap API. This server offers real-time price data, market analysis, and historical trends through an easy-to-use interface. Updated to use Coin Cap API v3
Updated 12 days ago (2026-09-29 00:30 UTC)
3
73 npm
1
MIT
Realtime Crypto MCP Server
Cryptocurrency Data Platforms
smhnkmr
A
license
Not graded
quality
D
maintenance
A server that provides real-time cryptocurrency data through the Model Context Protocol, allowing access to detailed exchange information and current cryptocurrency rates from the CoinCap API.
Updated 2 years ago (2025-04-05 03:19 UTC)
10 npm
1
MIT
Crypto Price MCP Server
Cryptocurrency Finance Search
whitmanca
F
license
B
quality
D
maintenance
A Model Context Protocol server that provides real-time cryptocurrency price fetching capabilities using the CoinGecko API. It enables LLMs to retrieve and process the latest price for any coin by its name or symbol.
Updated a year ago (2025-09-12 18:47 UTC)
2
-