{"id":50834286,"url":"https://github.com/friendlygeorge/coingecko-mcp-server","last_synced_at":"2026-06-14T02:11:02.056Z","repository":{"id":362849139,"uuid":"1260846262","full_name":"friendlygeorge/coingecko-mcp-server","owner":"friendlygeorge","description":"MCP server for CoinGecko — crypto prices, market data, trending coins. No API key required.","archived":false,"fork":false,"pushed_at":"2026-06-06T06:55:41.000Z","size":19,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-06T08:20:28.138Z","etag":null,"topics":["coingecko","crypto","mcp","model-context-protocol","prices"],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/friendlygeorge.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":["nova"]}},"created_at":"2026-06-06T00:03:21.000Z","updated_at":"2026-06-06T06:55:44.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/friendlygeorge/coingecko-mcp-server","commit_stats":null,"previous_names":["friendlygeorge/coingecko-mcp-server"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/friendlygeorge/coingecko-mcp-server","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/friendlygeorge%2Fcoingecko-mcp-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/friendlygeorge%2Fcoingecko-mcp-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/friendlygeorge%2Fcoingecko-mcp-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/friendlygeorge%2Fcoingecko-mcp-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/friendlygeorge","download_url":"https://codeload.github.com/friendlygeorge/coingecko-mcp-server/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/friendlygeorge%2Fcoingecko-mcp-server/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34306810,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-14T02:00:07.365Z","response_time":62,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["coingecko","crypto","mcp","model-context-protocol","prices"],"created_at":"2026-06-14T02:11:01.453Z","updated_at":"2026-06-14T02:11:02.049Z","avatar_url":"https://github.com/friendlygeorge.png","language":"JavaScript","funding_links":["https://github.com/sponsors/nova"],"categories":[],"sub_categories":[],"readme":"# CoinGecko MCP Server\n\n\u003e 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","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffriendlygeorge%2Fcoingecko-mcp-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffriendlygeorge%2Fcoingecko-mcp-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffriendlygeorge%2Fcoingecko-mcp-server/lists"}