Coingecko MCP Server

@cyanheads/coingecko-mcp-server Market data for 15,000+ cryptocurrencies — prices, history, trends, and deep coin metadata via CoinGecko. 8 Tools • 2 Resources • 1 Prompt

Overview

Cryptocurrency market data from CoinGecko — prices, rankings, historical charts, and deep coin profiles across 15,000+ coins. Resolve a name or ticker to CoinGecko's slug-keyed ID, then chain into price lookups, ranked markets, and trend charts.

Tools

Resources

All resource data is also reachable via tools — the resources mirror coingecko_get_coin and coingecko_get_global exactly, so tool-only clients lose nothing. Large collections (markets, categories) are not exposed as resources; use coingecko_list_markets and coingecko_list_categories instead.

Prompts

Capability reference

coingecko_search_coins tool

• Tickers are not unique (many coins share ETH/USDC) — returns ranked candidates with id, symbol, name, and marketCapRank to disambiguate
• Returns the top 25 matches by relevance; enrichment.truncated plus shown/cap disclose when the list is capped
• An empty result is a normal outcome, not an error — enrichment.notice suggests broadening the query

coingecko_get_prices tool

• Accepts up to 500 raw IDs (trimmed, lowercased, deduplicated) and processes the first 250 unique slugs; skippedIds lists the rest and missing lists ids that didn't resolve, since an unknown slug returns an empty upstream response rather than an error
• One row per (id, currency) that returned a price; market cap, 24h volume, and 24h change are optional per row. Currencies with no quotes are noted in enrichment.notice
• lastUpdatedAtUnixSec is Unix seconds — coingecko_get_market_chart's point timestamps are milliseconds
• Throws all_missing when no requested id resolves, no_price_data when IDs resolve but no requested currency returns a numeric quote

coingecko_list_markets tool

• Sort by market cap, volume, or ID, ascending or descending, via order; paginate with page and per_page (default 50, max 250 rows)
• Filter by ids (same 500-raw/250-unique bounds as price batches; appliedIds and skippedIds show the selection) or by category (a categoryId from coingecko_list_categories), not both — combining them returns conflicting_filters
• Per-coin fields include price, cap, volume, 1h/24h/7d change, supply, and ATH/ATL; enrichment.truncated flags a full page
• Throws unknown_category when CoinGecko returns HTTP 404 for a category-filtered request

coingecko_get_coin tool

• Six sections — profile, market, links, developer, community, sentiment; sections trims the response to just what's needed (the full record is large)
• Prices and percentage-change windows use vs_currency (defaults to usd); missing upstream fields are omitted rather than fabricated
• profile.categories are display names (e.g. "Layer 1 (L1)"), distinct from the categoryId slugs coingecko_list_categories returns
• Throws coin_not_found when the slug isn't recognized upstream, unsupported_currency when the requested market currency isn't a supported one

coingecko_get_market_chart tool

• recent mode takes 1–365 days ("max" aliases the 365-day window and emits a notice); range mode takes from/to as Unix seconds
• interval selects auto (upstream default), daily, or hourly, subject to upstream tier/window availability
• Pages with point_offset (default 0) and point_limit (default 100, cap 250); per-series totals and nextPointOffset support continuation, and each page refetches upstream data
• granularity reports the series spacing as 5-minute, hourly, daily, irregular, or unknown; point timestamps are Unix milliseconds, while coingecko_get_prices's lastUpdatedAtUnixSec is seconds
• Throws invalid_range on a mode/parameter mismatch, coin_not_found when the slug isn't recognized

coingecko_get_trending tool

• No parameters — 24-hour trending coins by search volume, each with marketCapRank, priceUsd, priceBtc, and priceChangePercentage24hUsd when available
• Upstream reports market cap and volume as pre-formatted display strings, not numbers — those fields are omitted rather than presented as numeric data
• nftCount reports the trending-NFT count upstream also returns; NFT detail itself isn't surfaced

coingecko_get_global tool

• No coin id needed — one call for the macro snapshot
• vs_currency (default usd) scopes only total market cap and volume; dominance and the 24h change percentages are always USD-denominated upstream
• Throws unsupported_currency when the requested currency has no entry in upstream's per-currency maps — /global has no upstream currency validation, so an unknown code silently returns no totals
• Returns active-cryptocurrency and active-market counts, ongoing ICO count, and a Unix-second snapshot timestamp

coingecko_list_categories tool

• Optional name_contains filters by whitespace-separated tokens, case- and punctuation-insensitive; every token must appear in the name
• enrichment.totalCount reports the full category count before filtering; a filter that matches nothing returns enrichment.notice
• Returned categoryId values are what coingecko_list_markets's category param expects

coingecko://coin/{id} resource

• Same data as coingecko_get_coin's full record, always denominated in USD
• {id} is a CoinGecko slug (e.g. "bitcoin") — resolve tickers with coingecko_search_coins
• Throws coin_not_found when the slug isn't recognized upstream

coingecko://global resource

• Same data as coingecko_get_global, always denominated in USD
• No parameters

coingecko_coin_research prompt

• Argument: coin required — a name, ticker, or CoinGecko slug
• Returns an assistant framing message plus a user message that walks the search → get_coin → get_market_chart → get_global chain

Features

Built on @cyanheads/mcp-ts-core: stdio and Streamable HTTP transports, pluggable auth (none / jwt / oauth), swappable storage (in-memory, filesystem, Supabase, Cloudflare KV/R2/D1), structured logging with optional OpenTelemetry tracing.

CoinGecko-specific:

• Type-safe client for the CoinGecko v3 REST API, with one service method per endpoint
• Runs keyless on the public tier; an optional Demo API key (x-cg-demo-api-key) raises the rate ceiling with no other config change
• Retry/backoff for rate limits, transient upstream failures, and timeouts; honors Retry-After, and permanent refusals fail immediately
• Status-specific error reasons with recovery hints, including narrowing the range on historical-window restrictions

Agent-friendly output:

• Search-before-query enforced through descriptions — every ID-keyed tool states slugs-not-tickers and points back to coingecko_search_coins
• Partial reads — price results disclose unresolved IDs and currencies without quotes; enrichment discloses caps and applied filters
• Units made explicit — timestamp fields document seconds vs. milliseconds
• Required CoinGecko attribution ships on every tool and resource output; the research prompt instructs the agent to attribute its findings the same way

Getting started

Add the following to your MCP client configuration file. No API key is required — set COINGECKO_API_KEY only to attach the higher CoinGecko Demo tier (see Configuration).

{

"mcpServers": { "coingecko-mcp-server": { "type": "stdio", "command": "bunx", "args": ["@cyanheads/coingecko-mcp-server@latest"], "env": { "MCP_TRANSPORT_TYPE": "stdio", "MCP_LOG_LEVEL": "info" } } } }

Or with npx (no Bun required):

{

"mcpServers": { "coingecko-mcp-server": { "type": "stdio", "command": "npx", "args": ["-y", "@cyanheads/coingecko-mcp-server@latest"], "env": { "MCP_TRANSPORT_TYPE": "stdio", "MCP_LOG_LEVEL": "info" } } } }

Or with Docker:

{

"mcpServers": { "coingecko-mcp-serve