{
  "markdown": "# CoinGecko MCP Server\n\n> An MCP server for [CoinGecko](https://www.coingecko.com) — connect any MCP-compatible client to free crypto market data.\n\n[![npm version](https://img.shields.io/npm/v/@supernova123/coingecko-mcp-server)](https://www.npmjs.com/package/@supernova123/coingecko-mcp-server)\n[![npm downloads](https://img.shields.io/npm/dm/@supernova123/coingecko-mcp-server)](https://www.npmjs.com/package/@supernova123/coingecko-mcp-server)\n[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)\n[![MCP Compatible](https://img.shields.io/badge/MCP-compatible-blueviolet)](https://modelcontextprotocol.io)\n[![TypeScript](https://img.shields.io/badge/TypeScript-5.5-blue)](https://www.typescriptlang.org/)\n[![Claude Desktop](https://img.shields.io/badge/Claude%20Desktop-ready-orange)](https://claude.ai/download)\n[![Cursor](https://img.shields.io/badge/Cursor-compatible-blue)](https://cursor.sh)\n\n## What is this?\n\nAn [MCP (Model Context Protocol)](https://modelcontextprotocol.io) server that gives AI assistants and agents access to CoinGecko's free crypto market data API — prices, market caps, trending coins, historical data, and global stats — through natural language.\n\nUse it with **Claude Desktop**, **Cursor**, **Windsurf**, **Cline**, **Continue**, or any MCP-compatible client to ask questions about crypto markets, compare tokens, and track prices.\n\n## Why use this?\n\n- **No API key required** — CoinGecko's free tier works out of the box (rate-limited to ~27 calls/min)\n- **8 built-in tools** — covers the most common crypto data queries\n- **Clean markdown output** — results read naturally in chat\n- **Rate-limited automatically** — respects free tier limits, retries on 429\n\n## Tools\n\n| Tool | Description |\n|------|-------------|\n| `search_coins` | Search for cryptocurrencies by name or symbol |\n| `get_prices` | Get current prices, market caps, and 24h changes for one or more coins |\n| `get_market_overview` | Get top N coins by market cap with full stats |\n| `get_trending` | Get currently trending coins (last 24h search volume) |\n| `get_coin_details` | Get detailed info about a specific coin (description, links, market data, categories) |\n| `get_price_history` | Get historical price data (daily, weekly, monthly, yearly) |\n| `get_global_stats` | Get global crypto market stats (total MCap, BTC dominance, active cryptos) |\n| `get_token_price_comparison` | Compare prices and stats of multiple tokens side-by-side |\n\n## Quick Start\n\n### 1. Add to your MCP client\n\nAdd this to your MCP client config (e.g. `claude_desktop_config.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"coingecko\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"coingecko-mcp-server\"]\n    }\n  }\n}\n```\n\nThat's it. No API key, no install step. npx downloads and runs it automatically.\n\n### 2. Use it\n\nAsk your AI assistant things like:\n\n- \"What's the current price of Bitcoin and Ethereum?\"\n- \"Show me the top 10 coins by market cap\"\n- \"What's trending on CoinGecko right now?\"\n- \"Compare Solana, Avalanche, and Polkadot\"\n- \"How has Bitcoin performed over the last 30 days?\"\n- \"What's the total crypto market cap and BTC dominance?\"\n- \"Search for AI-related crypto tokens\"\n- \"Tell me about Chainlink — categories, links, market data\"\n\n## Example Output\n\n### `get_trending`\n\n```\n🔥 Trending Coins (last 24h):\n\n1. Bitcoin (BTC) — Rank #1 | MCap: $1,340.2B | 24h: +2.1%\n2. Ethereum (ETH) — Rank #2 | MCap: $412.8B | 24h: +1.8%\n3. Solana (SOL) — Rank #5 | MCap: $78.4B | 24h: +4.3%\n...\n```\n\n### `get_token_price_comparison`\n\n```\nToken Comparison (USD):\n\n| Coin | Price | MCap | 24h | 7d | Vol |\n|------|-------|------|-----|-----|-----|\n| Bitcoin (BTC) | $67,234 | $1,340.2B | +2.1% | +5.3% | $28,400M |\n| Ethereum (ETH) | $3,456 | $412.8B | +1.8% | +3.1% | $14,200M |\n| Solana (SOL) | $178.5 | $78.4B | +4.3% | +12.1% | $3,800M |\n```\n\n## Use Cases\n\n### Portfolio Research\nAsk \"What's my portfolio worth?\" after listing your holdings. The server compares prices across multiple tokens and gives you a snapshot with market caps, 24h changes, and volume.\n\n### Yield Farming Research\n\"Show me trending coins with high volume\" — find new opportunities by checking what's getting attention. Combine with `get_coin_details` to deep-dive into categories and links before committing.\n\n### Market Intelligence\n\"What's the total crypto market cap and BTC dominance?\" gives you macro context in seconds. Use `get_global_stats` before making any allocation decision.\n\n### Token Comparison\n\"Compare Solana, Avalanche, and Polkadot\" — side-by-side price, market cap, and performance data. Faster than opening three tabs on CoinGecko.\n\n### Historical Analysis\n\"How has Bitcoin performed over the last 30 days?\" — daily price history for trend analysis. Works with any timeframe (daily, weekly, monthly, yearly).\n\n## Security\n\n- **No API key by default** — uses CoinGecko's free tier. Optional API key for higher rate limits.\n- **Read-only** — only fetches public market data from CoinGecko's API. No writes, no mutations.\n- **No local file access** — does not read or write any files on your machine.\n- **No shell access** — does not execute commands or spawn processes.\n- **Rate-limited** — automatically caps requests to stay within free tier limits.\n- **Open source** — MIT licensed. Inspect the code at [GitHub](https://github.com/friendlygeorge/coingecko-mcp-server).\n\n## Troubleshooting\n\n### Rate limit errors (429)\nThe server auto-retries on 429, but if you're making rapid queries, add a short delay between requests. Free tier allows ~27 calls/minute. If you hit this frequently, set a `COINGECKO_API_KEY` for higher limits.\n\n### \"Coin not found\" errors\nUse `search_coins` first to find the correct CoinGecko ID. Coin IDs are lowercase slugs (e.g. `bitcoin`, `ethereum`, `solana`), not ticker symbols.\n\n### Server won't start\nMake sure Node.js 18+ is installed: `node --version`. If using npx, ensure npm is up to date: `npm install -g npm@latest`.\n\n### MCP client can't connect\nVerify the config path is correct. Claude Desktop uses `~/Library/Application Support/Claude/claude_desktop_config.json` on macOS and `%APPDATA%\\Claude\\claude_desktop_config.json` on Windows. Restart the client after config changes.\n\n### Slow responses\nCoinGecko's free tier has ~300ms latency per call. Multi-coin queries (`get_prices`, `get_token_price_comparison`) make one API call regardless of how many coins you pass, so batch your queries.\n\n## Requirements\n\n- Node.js 18+\n- No API key needed (CoinGecko free tier)\n\n## Rate Limits\n\nThe server automatically rate-limits requests to ~27 calls/minute to stay within CoinGecko's free tier. If you have a CoinGecko Pro API key, you can set the `COINGECKO_API_KEY` environment variable for higher limits:\n\n```json\n{\n  \"mcpServers\": {\n    \"coingecko\": {\n      \"command\": \"coingecko-mcp-server\",\n      \"env\": {\n        \"COINGECKO_API_KEY\": \"your_key_here\"\n      }\n    }\n  }\n}\n```\n\n## Development\n\n```bash\ngit clone https://github.com/nova/coingecko-mcp-server.git\ncd coingecko-mcp-server\nnpm install\nnpm run build\nnpm start\n```\n\n## License\n\nMIT\n",
  "bytes": 7084,
  "sha": "ead6d43ee63fc7c0d238bcc467295122b7bb3e0b1de202cd9fba1d051eb50a2f",
  "repo_slug": "friendlygeorge/coingecko-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_friendlygeorge_coingecko_mcp_s_1d6f2b3e/readme"
}