coinmarketcap-keyless-mcp
This server is a read-only, keyless CoinMarketCap MCP server exposing narrow, typed tools that return the provider's raw status/data envelope for market research — no credentials, no writes, no trading.
Resolve asset identity:
cmc_crypto_mapturns symbols/names into canonical CMC IDs and identifiers (sort by id orcmc_rank, listing status filter, up to 500 records).Read static metadata:
cmc_crypto_inforeturns metadata for known coins by CMC IDs, slugs, or symbols.Get current market prices:
cmc_quotes_latestfetches latest quotes for a known asset set (IDs/slugs/symbols), converting to up to 3 currencies.Scan the market broadly:
cmc_listings_latestgives a ranked, paginated market list with many sort fields (market cap, volume, percent changes) and asc/desc direction.Read aggregate market state:
cmc_global_metrics_latestreturns total market cap, volume, and dominance.Gauge sentiment:
cmc_fear_greed_latestandcmc_fear_greed_historical(paginated daily series) expose the Crypto Fear & Greed Index.Track altcoin rotation:
cmc_altcoin_season_latestandcmc_altcoin_season_historical(7d/30d/90d timeframes) expose the Altcoin Season Index.Read index data:
cmc_cmc100_latest/cmc_cmc100_historicalandcmc_cmc20_latest/cmc_cmc20_historicalreturn index values, constituents, and weights, with bounded history (max 10 points, 5m/15m/daily intervals, explicit time window).Operate safely: every tool is a fixed allowlisted
GETroute overhttps://pro-api.coinmarketcap.com/public-api, rejects unknown arguments, enforces bounded limits/pagination, uses no API key or auth header, and passes provider text through verbatim (treat as untrusted).Note: this schema lists 13 tools; the project documents 20 total, with the remaining 7 (simple price, categories, price conversion, exchange map, and two DEX tools) not present here.
Provides read-only access to selected CoinMarketCap Keyless Public API routes for cryptocurrency data, including asset mapping and metadata, latest quotes and ranked listings, global market metrics, Fear & Greed and Altcoin Season indices, and CMC100/CMC20 index values and history.
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., "@coinmarketcap-keyless-mcp what's the current price of bitcoin and ethereum?"
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.
coinmarketcap-keyless-mcp
coinmarketcap-keyless-mcp is a bounded, read-only Model Context Protocol (MCP) server for selected CoinMarketCap Keyless Public API routes. It requires no CoinMarketCap account, API key, secret, wallet, or authentication header. Upstream access is fixed to https://pro-api.coinmarketcap.com/public-api and uses GET only.
The surface is deliberately narrow: exactly 20 typed tools, each mapped to one allowlisted route. These are the 13 v1 tools, plus five Standard tools and two read-only DEX identity tools added in v1.1 (see V1_1_PLAN.md). It does not expose a generic URL/path proxy, authenticated fallback, or any other DEX route.
Tool catalog
Tool | Route | Purpose |
|
| Resolve canonical CoinMarketCap IDs and identifiers. |
|
| Read static metadata for known assets. |
|
| Read current quotes for known assets. |
|
| Read a ranked, paginated current market list. |
|
| Read aggregate market capitalization, volume, and dominance metrics. |
|
| Read the current Fear & Greed value and classification. |
|
| Read paginated historical Fear & Greed values. |
|
| Read the current Altcoin Season Index snapshot. |
|
| Read Altcoin Season Index history for a supported timeframe. |
|
| Read the current CMC100 value, constituents, and weights. |
|
| Read bounded CMC100 historical values. |
|
| Read the current CMC20 value, constituents, and weights. |
|
| Read bounded CMC20 historical values. |
|
| Read the latest simple price for known assets. |
|
| List cryptocurrency categories and their IDs. |
|
| Read one category and a page of its coins. |
|
| Convert an amount of one cryptocurrency into one target currency. |
|
| Resolve exchange IDs and slugs. |
|
| List the blockchain platforms supported by CoinMarketCap DEX data. |
|
| Read the current DEX price of one token by platform name and contract address. |
Numeric CMC IDs are preferred over ticker symbols where practical because symbols can be ambiguous. Tool schemas reject unknown arguments, enforce bounded list/pagination inputs, and validate cross-field constraints locally. cmc_dex_token_price passes the platform name and token address through with their case unchanged; use cmc_dex_platform_list to find accepted platform names.
Related MCP server: EODHD MCP Server
Requirements and development
Python 3.11 or newer is required. The documented workflow uses uv:
uv sync
uv run pytest -qThe package reports the version declared in pyproject.toml. Runtime dependencies are mcp, httpx, and uvicorn (for Streamable HTTP); test dependencies are provided by the dev dependency group.
Transports
The canonical local stdio command is:
uv run coinmarketcap-keyless-mcpIt keeps stdout reserved for MCP protocol traffic; diagnostics go to logging/stderr. The same command's help is available with uv run coinmarketcap-keyless-mcp --help.
For Codex CLI, use the tested command directly and provide no secret environment variables:
[mcp_servers.coinmarketcap_keyless]
command = "uv"
args = ["run", "coinmarketcap-keyless-mcp"]The secondary Streamable HTTP transport is intended for local use. It binds to 127.0.0.1:8000 by default and exposes MCP at /mcp:
uv run coinmarketcap-keyless-mcp --transport streamable-httpUse --host and --port to choose the local bind address and port, for example --host 127.0.0.1 --port 8001. This is not an internet-facing hosted service: the HTTP transport has no authentication, so anyone who can reach it can spend this machine's keyless CoinMarketCap rate limit. Binding to a non-loopback host such as 0.0.0.0 logs a warning to stderr. Both transports expose the same 20 tools and schemas.
Behavior and errors
The server preserves the provider's status and data envelope rather than inventing derived market indicators. Provider text fields (for example project descriptions) are passed through verbatim, so treat them as untrusted input to the model. A successful HTTP 2xx response must also have a valid CMC envelope with normalized status.error_code == 0.
Validation failures are INVALID_ARGUMENT. Exhausted HTTP 429 retries are RATE_LIMITED, never UNSUPPORTED_ROUTE. Timeout, network, and retryable 5xx failures retain transient upstream classifications; malformed successful responses are UPSTREAM_CONTRACT_MISMATCH; provider application errors are UPSTREAM_APPLICATION_ERROR. Unsupported capability is recorded only with positive evidence.
Retries are bounded and apply to 429, 502/503/504, and selected network/timeouts. Valid Retry-After values within the backoff cap are honored; a longer Retry-After ends retrying immediately with the final classification (for example RATE_LIMITED) instead of retrying early; otherwise capped exponential backoff with jitter is used. Each attempt also has a 30-second wall-clock deadline. Deterministic non-429 4xx responses are not retried. Non-retryable 4xx errors include the provider's error message when the body carries one (read up to 4 KiB, sanitized). The client uses a bounded (64-entry) process-local TTL cache for successful responses only, coalesces identical concurrent cold requests into one upstream fetch, with route-specific short TTLs for volatile data and a default maximum of two concurrent upstream requests. Caching is an optimization, not a correctness dependency.
Live keyless capability verification
Live verification is opt-in and separate from ordinary offline tests:
uv run python -m coinmarketcap_keyless_mcp.verify_liveIt serially probes one minimal call for each of the 20 routes against the fixed keyless base URL without credentials and writes a timestamped, minimized JSON report under verification/. To rerun one selected ambiguous or transient route:
uv run python -m coinmarketcap_keyless_mcp.verify_live --tool cmc_quotes_latestClassifications are:
SUPPORTED: the keyless response passed the route's minimum shape checks;RATE_LIMITED: the route exhausted HTTP 429 handling;TRANSIENT_ERROR: a timeout, network, or retryable upstream failure prevented a conclusion;CONTRACT_MISMATCH: the response envelope or minimum route shape was not valid;UNSUPPORTED: positive provider evidence indicates the keyless capability is unavailable.
The command exits 0 only when every probed route is SUPPORTED, 1 otherwise, and 2 if the run or evidence write fails.
The current release evidence is verification/live-capability-20261001T151943758586Z.json, produced by the manual live-release-qualification.yml workflow (run 36883326560) on the exact 1.0.2 release commit b486dec35b0a6849abaa5f0ade8633b08ebafa4a; see verification/release-1.0.2.md. It records all 13 released routes as SUPPORTED with HTTP 200 and provider error code 0, the exact fixed base URL, timestamps, no credentials, and server version 1.0.2; reports intentionally retain no full provider payloads. The status is LIVE_KEYLESS_CORE_VERIFIED. The earlier Phase 5 evidence for pre-release 0.1.0 (verification/live-capability-20261001T015531675887Z.json, with the selected historical-route rerun in verification/live-capability-20261001T015419204714Z.json) is kept for history. CoinMarketCap can change keyless coverage or rate-limit behavior, so rerun the full command or a selected route after provider changes and before a later release qualification. Do not infer unsupported capability from one 429 or transient failure.
That evidence covers the 13 v1 routes only. The seven v1.1 routes have mocked, non-live verification and independent acceptance records (verification/v1.1-e1r-contract-review.md, verification/v1.1-e2a-contract-review.md), but no live evidence yet; the v1.1 live release gate is still pending.
Tests
The required non-live qualification commands are:
uv sync
uv run pytest tests/unit -q
uv run pytest tests/contract -q
uv run pytest tests/mcp -q
uv run pytest tests/mcp/test_stdio.py -q
uv run pytest tests/mcp/test_streamable_http.py -q
uv run pytest -q
git diff --checkTests use fixtures, mocks, local subprocesses, and a localhost HTTP server; they do not require live CoinMarketCap access.
Explicit non-goals
This package provides no trading, order placement, wallets, signing, custody, transactions, credentials, API-key configuration, authenticated fallback, DEX surface beyond the two read-only DEX tools above, generic proxy, investment advice, portfolio construction, or locally derived investment-advice logic. It does not silently transform provider values into locally derived indicators.
The exact contract is encoded in src/coinmarketcap_keyless_mcp/contracts.py, and the product boundary is defined in PLAN.md and, for the v1.1 additions, V1_1_PLAN.md.
License
MIT. See LICENSE.
Available Tools
13 toolscmc_altcoin_season_historicalC
Get CoinMarketCap Altcoin Season Index history for one provider-supported timeframe.
Inputs: timeframe. Returns: data, status
cmc_altcoin_season_latestB
Get the latest CoinMarketCap Altcoin Season Index snapshot.
Inputs: no named parameters. Returns: data, status
cmc_cmc100_historicalC
Get historical CoinMarketCap 100 Index values at a provider-supported interval.
Inputs: count, interval, time_end, time_start. Returns: data, status
cmc_cmc100_latestA
Get the latest CoinMarketCap 100 Index value, constituents, and constituent weights.
Inputs: no named parameters. Returns: data, status
cmc_cmc20_historicalC
Get historical CoinMarketCap 20 Index values at a provider-supported interval.
Inputs: count, interval, time_end, time_start. Returns: data, status
cmc_cmc20_latestA
Get the latest CoinMarketCap 20 Index value, constituents, and constituent weights.
Inputs: no named parameters. Returns: data, status
cmc_crypto_infoC
Get CoinMarketCap metadata for known cryptocurrencies. Numeric CMC IDs are preferred because symbols are not globally unique.
Inputs: ids, slugs, symbols, skip_invalid. Returns: data, status
cmc_crypto_mapB
Resolve CoinMarketCap cryptocurrency IDs and canonical identifiers. Prefer this tool before symbol-based research when an asset's CMC ID is not already known.
Inputs: sort, limit, start, symbols, +1 more. Returns: data, status
cmc_fear_greed_historicalB
Get historical CoinMarketCap Crypto Fear and Greed values, paginated from the provider's daily series.
Inputs: limit, start. Returns: data, status
cmc_fear_greed_latestA
Get the latest CoinMarketCap Crypto Fear and Greed Index value and classification.
Inputs: no named parameters. Returns: data, status
cmc_global_metrics_latestC
Get CoinMarketCap's latest aggregate crypto-market metrics, including market capitalization, volume, and dominance measures.
Inputs: convert. Returns: data, status
cmc_listings_latestA
Get a ranked, paginated list of active cryptocurrencies with current market data. Use this tool for market breadth/ranking; use cmc_quotes_latest for a known small asset set.
Inputs: sort, limit, start, convert, +1 more. Returns: data, status
cmc_quotes_latestB
Get the latest CoinMarketCap market quotes for a known set of cryptocurrencies. Prefer CMC IDs over symbols when identity ambiguity matters.
Inputs: ids, slugs, convert, symbols, +1 more. Returns: data, status
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 13 tools
Each tool targets a distinct data type or time window (latest vs historical for indices, fear & greed, altcoin season; separate tools for ID resolution, metadata, quotes, listings, global metrics). No two tools overlap significantly.
All tools use a consistent snake_case pattern with the cmc_ prefix and a noun_qualifier structure (e.g., cmc_cmc100_historical, cmc_quotes_latest). The convention is predictable throughout.
13 tools is well-scoped for a market data server, covering several indices, sentiment indicators, and core market queries without excessive redundancy.
The set covers latest and historical data for indices and sentiment, but lacks historical data for individual cryptocurrency quotes/prices and global metrics history. This is a notable gap for a comprehensive market data API.
Maintenance
Related MCP Connectors
Read-only crypto, equities, FX and commodities market data. No trading tools. API key required.
Read-only educational MCP for CryptoDecentral Sovereign. No auth, trading, custody, or advice.
33 pay-per-call market and news data tools over MCP with free discovery and x402 payments.
Free read-only crypto whale-tracking & market-data MCP tools across 14 chains. No auth.
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 gradedqualityDmaintenanceEnables access to financial market data including EOD, intraday, fundamentals, news, and more via 75 read-only MCP tools.5MIT
- AlicenseNot gradedqualityCmaintenanceEnables read-only access to Hyperliquid's public market, user, vault, and staking data via 61 MCP tools, covering perpetuals, spot, and borrow-lend information.MIT
- AlicenseAqualityCmaintenanceExposes public marketplace data — offerings, screening and comparison, news, sponsor listings, and platform reference text — as typed read-only tools any MCP-compatible agent can call without an API key or account. Every response carries provenance, honest nulls for undisclosed values, and a standing disclaimer, and no registered tool can write or transact by default.9Apache 2.0