cmc-market-agent
Provides tools for accessing live CoinMarketCap market data, including price quotes, top listings, trending coins, gainers/losers, symbol search, historical OHLCV candles, global market metrics, the Fear & Greed index, and a composed market brief.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@cmc-market-agent What's the price of BTC and ETH right now?"
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.
CMC Market Agent
MCP server + CLI agent that puts live CoinMarketCap market data in front of LLMs.
Built for Build with CMC: API Hackathon, Round 2 — track AI Agents and Automation (official page).
An LLM's training data goes stale the day it's cut off. This project gives any MCP-compatible LLM (Claude Desktop, VS Code, Claude Code, …) nine tools to answer crypto questions from live CoinMarketCap data instead of guessing: prices, top listings, trending coins, gainers/losers, OHLCV history, global market totals, and the Fear & Greed index — plus a one-call market brief.
Quick start
git clone https://github.com/melatim80186/cmc-market-agent.git
cd cmc-market-agent
npm install
npm run buildDemo (no key needed)
Without an API key the server runs on clearly-labelled mock data, so the demo always works:
npm run demo # exercises all 9 tools end-to-end
npm run brief # one-page market brief
npm run ask -- "price of BTC and ETH"
npm run ask -- "top gainers today"
npm run ask -- "BTC chart last 7 days"
npm test # 11 tests, mock mode, no network
npm run smoke # speaks raw MCP JSON-RPC to the server over stdioLive data (needs a free CMC API key)
cp .env.example .env # then put your key in .env — or export CMC_API_KEY
export CMC_API_KEY=your-key-here
npm run briefGet a free key at https://coinmarketcap.com/api/. Hackathon participants
get a free Startup tier upgrade for the event window after registering on
DoraHacks with the email on their CMC account. The key is read only from
the environment — it is never written to a file and never committed
(.gitignore blocks .env).
MCP server (Claude Desktop etc.)
npm start # stdio transport; CMC_API_KEY=... for live dataAdd to Claude Desktop config (see examples/claude_desktop_config.json —
replace the path and the key):
{
"mcpServers": {
"cmc-market-agent": {
"command": "node",
"args": ["/absolute/path/to/cmc-agents/dist/server.js"],
"env": { "CMC_API_KEY": "PASTE_YOUR_CMC_API_KEY_HERE" }
}
}
}Then ask Claude things like "What's BTC doing today vs ETH?", "Who are the top gainers this week?" or "Give me the morning market brief" — it will call the tools instead of guessing.
Related MCP server: CoinMarketCap Universal MCP Server
Tools (9)
Tool | CMC endpoint | What it does |
|
| Price, 24h/7d change, volume, market cap for 1+ symbols |
|
| Top coins ranked by market cap |
|
| Coins trending on CMC right now |
|
| Top gainers / losers (1h, 24h, 7d, 30d) |
|
| Resolve a symbol to CMC id, slug, rank |
|
| Daily OHLCV candles, last N days |
|
| Total market cap, volume, BTC/ETH dominance |
|
| Fear & Greed index (0–100 + label) |
| (composes the above) | One-call digest: top coins, top mover, Fear & Greed, totals |
Every tool response is stamped data_source: "live" | "sandbox" | "mock", and
mock responses carry an explicit mock_notice — mock numbers can never be
mistaken for live prices.
Project layout
src/
server.ts MCP server (stdio) — the 9 tools above
agent.ts CLI agent: `brief` + plain-English `ask` (keyword intent router)
demo.ts end-to-end demo of all tools
tools.ts shared tool layer (used by server + CLI)
cmc.ts thin CMC Pro API client
mock.ts clearly-labelled mock data (demo only)
config.ts env config — key from env only, mock when no key
tests/ node:test suite (mock mode, no network)
scripts/ MCP protocol smoke test (raw JSON-RPC over stdio)
examples/ Claude Desktop config
docs/ API notes + demo transcriptWhat the CMC API made possible / where it got in the way
See docs/API-NOTES.md — required reading for the
hackathon submission note. Short version: one API covers quotes, listings,
trending, OHLCV, global metrics and sentiment, which is exactly what an
agent needs; the friction was the sandbox host returning empty replies from
this environment (so the demo falls back to labelled mock data until a real
key is present) and /v1/cryptocurrency/map accepting symbols but not
free-text names.
Hackathon submission
Track: AI Agents and Automation
Deadline: 9 Dec 2026, 23:59 UTC · Results: 30 Dec 2026
Endpoints used: named explicitly in the table above and in
docs/API-NOTES.mdDemo:
npm run demo(seedocs/DEMO.mdfor a transcript); a screen recording of the live run is made once a real API key is availableStatus: NOT yet submitted on DoraHacks — submission needs the builder's DoraHacks account + X post (
#BuildwithCMC), both human steps
License
MIT — see LICENSE.
Available Tools
9 toolsget_fear_greedB
Crypto Fear & Greed index (0–100 + classification like Greed/Fear). Uses CMC endpoint /v1/global-metrics/quotes/fear-greed/latest.
Inputs: limit.
get_gainers_losersC
Top gainers and top losers over a time period. Uses CMC endpoint /v1/cryptocurrency/trending/gainers-losers.
Inputs: limit, time_period.
get_global_metricsA
Whole-market totals: total market cap, 24h volume, BTC/ETH dominance, active coins and exchanges. Uses CMC endpoint /v1/global-metrics/quotes/latest.
Inputs: convert.
get_listingsB
Top cryptocurrencies ranked by market cap. Uses CMC endpoint /v1/cryptocurrency/listings/latest.
Inputs: limit, convert.
get_market_briefA
One-call morning brief: top coins by market cap, biggest gainer/loser, Fear & Greed index and total market cap. Composed from the listings, gainers-losers, fear-greed and global-metrics endpoints.
Inputs: top_n.
get_ohlcvA
Daily OHLCV candles (open/high/low/close/volume/market cap) for one coin over the last N days. Uses CMC endpoint /v2/cryptocurrency/ohlcv/historical.
Inputs: symbol (required), days.
get_quoteA
Latest price, 24h/7d change, volume and market cap for one or more coins by symbol (e.g. BTC, ETH, SOL). Uses CMC endpoint /v1/cryptocurrency/quotes/latest.
Inputs: symbols (required), convert.
get_trendingB
Coins trending on CoinMarketCap right now. Uses CMC endpoint /v1/cryptocurrency/trending/latest.
Inputs: limit.
search_coinA
Resolve a coin symbol or name to its CoinMarketCap id, slug and rank. Use before get_ohlcv when you only know a symbol. Uses CMC endpoint /v1/cryptocurrency/map.
Inputs: query (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 9 tools
Each tool targets a distinct data slice: single-coin quotes, market-cap listings, trending, gainers/losers, OHLCV, global metrics, and fear & greed. The only real overlap is get_market_brief, which aggregates several of the others, but its description clearly frames it as a one-call convenience rather than a duplicate.
Almost everything follows a clean get_<resource> snake_case pattern (get_quote, get_listings, get_ohlcv, get_global_metrics). The sole deviation is search_coin, which uses a different verb despite being a resolution/lookup operation; readable but not perfectly uniform.
Nine tools is well within the sweet spot and every tool maps to a real analytical need for a crypto market agent. There is no filler or near-duplicate padding the surface.
The read-only market-data lifecycle is largely covered: discovery (listings, trending, search), pricing (quote, OHLCV), and sentiment/aggregates (global metrics, fear & greed, brief). Gaps are minor — no exchange-level or category/metadata lookup, and search_coin is required before OHLCV, which is a slight workflow dependency rather than a missing operation.
Maintenance
Related MCP Connectors
Official CoinMarketCap MCP server: real-time crypto prices, market cap, rankings and exchange data.
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.
Crypto market & research MCP for AI agents: prices, derivatives, options, on-chain, sentiment, news.
Financial data MCP server for Claude, ChatGPT, Cursor and Codex. Real-time stock quotes, financial statements, options flow, SEC filings, insider trades, 13F holdings, macro data and market news from gloom.sh, the open-source Bloomberg Terminal alternative.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that provides access to CoinMarketCap's cryptocurrency data, enabling AI applications to retrieve cryptocurrency listings, quotes, and detailed information.36-
- AlicenseNot gradedqualityDmaintenanceProvides comprehensive access to CoinMarketCap's cryptocurrency data including listings, quotes, market metrics, and the Fear & Greed Index directly within the Cursor environment.2MIT
- 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