Coingecko Mcp Server
by cyanheadscommunityv0.1.1
1
MCP server for CoinGecko crypto market data, providing tools to search coins by name or ticker, fetch current prices, market charts, coin details, trending coins, global stats, and category/market listings. It runs locally over stdio or HTTP and works keyless by default, with an optional CoinGecko Demo API key to increase rate limits.
From the registry: Crypto market data via CoinGecko — prices, markets, history, trending, and deep coin metadata.
Install & configure
Prerequisites
- optionalInstall Node.js or BunInstall Bun v1.3.2+ or Node.js v24+ to run the server. Prefer Node.js if using the npx install path.https://bun.sh/
- optionalOptional CoinGecko Demo API keyCreate a CoinGecko Demo API key if you want a higher rate ceiling. The server works without a key on the public tier.https://www.coingecko.com/en/api/pricing
Install in your client
Paste into the AI you're chatting with — it will figure out the rest
Please install the `coingecko-mcp-server` MCP server into my current AI client (that's you).
Optional prerequisites:
- Install Node.js or Bun — Install Bun v1.3.2+ or Node.js v24+ to run the server. Prefer Node.js if using the npx install path. (https://bun.sh/)
- Optional CoinGecko Demo API key — Create a CoinGecko Demo API key if you want a higher rate ceiling. The server works without a key on the public tier. (https://www.coingecko.com/en/api/pricing)
Canonical MCP server config (stdio transport):
- command: `npx`
- args: ["-y","@cyanheads/coingecko-mcp-server@latest"]
- required environment variables:
- `MCP_TRANSPORT_TYPE`: Transport type for the MCP server. Use stdio for client config. (example: `stdio`)
- optional environment variables:
- `MCP_LOG_LEVEL`: Log level in RFC 5424 format. (example: `info`)
- `COINGECKO_API_KEY`: Optional CoinGecko Demo API key sent as the x-cg-demo-api-key header for higher rate limits. (example: `<your-coingecko-demo-api-key>`)
- `MCP_HTTP_PORT`: Port for HTTP transport; not needed for stdio mode. (example: `<your-http-port>`)
- `MCP_HTTP_ENDPOINT_PATH`: HTTP endpoint path for HTTP transport; not needed for stdio mode. (example: `<your-http-endpoint-path>`)
- `MCP_AUTH_MODE`: Authentication mode: none, jwt, or oauth. (example: `<your-auth-mode>`)
- `LOGS_DIR`: Directory for log files (Node.js only). (example: `<your-logs-directory>`)
- `STORAGE_PROVIDER_TYPE`: Storage backend type. (example: `<your-storage-provider-type>`)
- `OTEL_ENABLED`: Enable OpenTelemetry instrumentation. (example: `<true-or-false>`)
Note: The README also documents HTTP mode, started separately by setting MCP_TRANSPORT_TYPE=http and MCP_HTTP_PORT, with the server listening at http://localhost:3010/mcp. For canonical client config, the simplest portable path is stdio via npx. No API key is required by default.
Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.Note: The README also documents HTTP mode, started separately by setting MCP_TRANSPORT_TYPE=http and MCP_HTTP_PORT, with the server listening at http://localhost:3010/mcp. For canonical client config, the simplest portable path is stdio via npx. No API key is required by default.
Tools (8)
coingecko_search_coins
Resolve a coin name or ticker symbol to a CoinGecko ID (slug).
coingecko_get_prices
Get current price and core market stats for one or more coins in one or more currencies.
coingecko_list_markets
List ranked coins by market cap, volume, or 24h price change, optionally filtered by category.
coingecko_get_coin
Fetch a deep single-coin profile including description, links, market data, developer activity, community, and sentiment.
coingecko_get_market_chart
Fetch historical price, market cap, and volume series for a coin over a recent range or explicit time window.
coingecko_get_trending
List coins trending on CoinGecko in the last 24 hours by search volume.
coingecko_get_global
Get a global crypto market snapshot including total market cap, volume, dominance, active counts, and 24h change.
coingecko_list_categories
List CoinGecko categories and their valid category IDs for filtering market listings.
Environment variables
COINGECKO_API_KEYOptional CoinGecko Demo API key that increases the rate limit ceiling.Prerequisites
- • Node.js v24+
Packages
@cyanheads/coingecko-mcp-server
npmv0.1.1transport: stdio
@cyanheads/coingecko-mcp-server
npmv0.1.1transport: streamable-http
Details
- Language
- TypeScript
- License
- Apache-2.0
- Released
- Jun 14, 2026
- Last commit
- Jun 14, 2026
- Registry name
- io.github.cyanheads/coingecko-mcp-server