CMC MCP Server
Provides tools for accessing live CoinMarketCap cryptocurrency data, including prices, quotes, listings, global market metrics, Fear & Greed, CMC100, altcoin season, DEX token search/security/pools, pair quotes, and candlestick data. Also offers composite workflows for market briefs, token due diligence, coin comparisons, and finding top movers.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
CMC MCP Server
A Model Context Protocol server that puts live CoinMarketCap data in front of any LLM — no API key required to start.
Built for the Build with CMC: API Hackathon Round 2 (DoraHacks, AI Agents and Automation track).
Why this is different from CMC's official MCP
CoinMarketCap ships an official hosted MCP server. It is useful, but:
Official CMC MCP | This server | |
API key | Required — you must create an account and key first | Keyless-first — works with zero setup via CMC's public keyless endpoint |
Tools | 12 plain one-endpoint tools | 20 tools, including 4 composite one-call workflows |
Hosting | Hosted by CMC (remote) | Local, self-hosted stdio — runs on your machine, your data stays yours |
Agent workflows | One tool call per question |
|
The composite tools are the point: an agent asking "how is the market today?"
should not need five round trips. market_brief does global metrics, Fear &
Greed, CMC100, Altcoin Season and the top 5 gainers/losers in a single call.
Related MCP server: mcp-coinmarketcap
Honest limits (keyless mode)
The keyless endpoint runs on a shared anonymous pool. When the pool is exhausted, CMC returns error 1022 ("You've reached the limit for anonymous access"). This server retries those calls with exponential backoff (1s / 2s / 4s / 8s) and, if the limit persists, tells you so plainly.
A free API key removes the limit and unlocks the full catalog — including
get_trending_gainers_losers, which is keyed-only and fails gracefully in
keyless mode. Get one at https://coinmarketcap.com/api/ and set
CMC_API_KEY. Never commit a key to a repo.
Live smoke test (2026-11-19, keyless, from a shared host): 3/3 calls succeeded — BTC $63,680.62, Fear & Greed 12 ("Extreme fear"), total market cap $2.175T, BTC dominance 58.9%.
Tools
Every tool names the CMC endpoint it calls.
Tool | CMC endpoint | Mode |
|
| keyless |
|
| keyless |
|
| keyless |
|
| keyless |
|
| keyless |
|
| keyless |
|
| keyless |
|
| keyless |
|
| keyless |
|
| keyless |
|
| keyless |
|
| keyless |
|
| keyless |
|
| keyless |
|
| keyless |
|
| keyed only |
| global metrics + fear/greed + CMC100 + altcoin season + listings | keyless |
| dex token + security + pools + price | keyless |
|
| keyless |
|
| keyless |
Note: find_movers deliberately does not use
/v1/cryptocurrency/trending/gainers-losers — that endpoint is keyed-only.
It derives gainers/losers from the keyless listings endpoint instead.
Setup
Requires Python 3.10+.
git clone https://github.com/<you>/cmc-mcp-server.git
cd cmc-mcp-server
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txtKeyless mode needs nothing else. For keyed mode:
export CMC_API_KEY="your-free-key" # never commit thisRun the server (stdio transport):
FASTMCP_CHECK_FOR_UPDATES=off python -m cmc_mcp.serverFASTMCP_CHECK_FOR_UPDATES=off skips FastMCP's startup version check, which
fails on proxied/sandbox networks.
Claude Code
claude mcp add cmc -- python -m cmc_mcp.serverOr add to ~/.claude.json / .mcp.json:
{
"mcpServers": {
"cmc": {
"command": "python",
"args": ["-m", "cmc_mcp.server"],
"cwd": "/path/to/cmc-mcp-server",
"env": {
"FASTMCP_CHECK_FOR_UPDATES": "off",
"CMC_API_KEY": "your-free-key"
}
}
}
}Omit CMC_API_KEY entirely for keyless mode.
Claude Desktop
Add to claude_desktop_config.json:
{
"mcpServers": {
"cmc": {
"command": "/path/to/cmc-mcp-server/.venv/bin/python",
"args": ["-m", "cmc_mcp.server"],
"cwd": "/path/to/cmc-mcp-server",
"env": { "FASTMCP_CHECK_FOR_UPDATES": "off" }
}
}
}Codex
codex mcp add cmc -- python -m cmc_mcp.serverOr in ~/.codex/config.toml:
[mcp_servers.cmc]
command = "python"
args = ["-m", "cmc_mcp.server"]
cwd = "/path/to/cmc-mcp-server"Example session
You: What's the Bitcoin price, and how is the market doing overall?
Agent →
get_price(symbols="BTC")→{ "prices": { "BTC": { "price": 63680.62, ... } } }Agent →
market_brief()→ total market cap $2.175T, 24h volume $72.4B, BTC dominance 58.9%, Fear & Greed 12 ("Extreme fear"), plus the CMC100 value, Altcoin Season Index and the day's top gainers/losers.Agent: Bitcoin is at $63,680.62. The market is in extreme fear (12/100) with a $2.18T total cap; BTC dominance is 58.9%.
Demo
See DEMO.md for the exact MCP Inspector command and three scripted demo prompts (price check → market brief → token due diligence).
Tests
pip install -r requirements-dev.txt
python -m pytest -q20 tests, all mocked (no network): keyless vs keyed base URL and header, exponential backoff on error 1022 (then success), graceful keyed-only error, and the aggregation logic of every composite tool.
Live smoke test against the real keyless API:
python scripts/smoke_live.pyVerify the server lists all 20 tools over stdio:
python scripts/verify_tools.pyWhat the API made possible / where it got in the way
The keyless catalog is generous: prices, quotes, listings, global metrics, Fear & Greed, CMC100, altcoin season and the whole DEX surface all work with no account — that is what makes a zero-setup MCP server possible.
The anonymous pool is shared and often exhausted (error 1022); the server retries with backoff, but a free key is the real fix for sustained use.
CMC is inconsistent about
error_code's type: some endpoints return the integer0, others the string"0"; the client normalises both. The/v2/simple/priceresponse also shipsdataas a list with aquotesarray rather than a symbol-keyed map — the server handles both shapes.listings/latestandquotes/latestreturnquoteas a list, not a dict, andquotes/latestwith several symbols returns every token sharing a symbol (wrapped variants, other chains — some with null prices). The server keeps the largest-market-cap entry per symbol.trending/gainers-losersis keyed-only, so the keylessfind_moversderives movers from listings instead — same answer, one extra sort. Even with a key the endpoint is plan-gated: a free Basic key is refused with error 1006 ("plan doesn't support this endpoint", verified 19 Nov 2026), sofind_moversstays the reliable fallback until the plan is upgraded — the hackathon Startup tier should unlock it.
License
MIT — see LICENSE.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Live crypto + IDX stock market intelligence for AI agents — 19 tools, no API key.
Web search, point-in-time crypto market data, verified strategy track records and 160+ agent tools.
Pay-per-use tool marketplace for AI agents. Search, price-check, and call APIs via MCP.
Open API Marketplace for AI Agents. Crypto data tools with USDC payments on Base.
Related MCP Servers
- AlicenseBqualityDmaintenanceProvides access to cryptocurrency market data, exchange information, and blockchain metrics through the CoinMarketCap API. Supports price quotes, historical data, trending tokens, global metrics, and DEX information across different subscription tiers.26MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to query cryptocurrency data including prices, market cap, rankings, categories, and global metrics from CoinMarketCap via MCP tools.103 npmMIT
- AlicenseCqualityDmaintenanceEnables access to CoinMarketCap API data, including latest cryptocurrency listings and token quotes, through natural language.2MIT
- FlicenseNot gradedqualityDmaintenanceEnables AI agents to access Coinmarketcap data through real API endpoints with no authentication required, supporting crypto and DeFi queries.-