{"_id":"@cyanheads/coingecko-mcp-server","_rev":"4-f331e4e47d1ca270239d70185dbb7f73","name":"@cyanheads/coingecko-mcp-server","dist-tags":{"latest":"0.1.3"},"versions":{"0.1.0":{"name":"@cyanheads/coingecko-mcp-server","version":"0.1.0","keywords":["mcp","mcp-server","model-context-protocol","coingecko","cryptocurrency","crypto","bitcoin","ethereum","market-data","defi","typescript","bun","stdio","streamable-http"],"author":"cyanheads <casey@caseyjhand.com> (https://github.com/cyanheads/coingecko-mcp-server#readme)","license":"Apache-2.0","_id":"@cyanheads/coingecko-mcp-server@0.1.0","maintainers":[{"name":"cyanheads","email":"casey@caseyjhand.com"}],"homepage":"https://github.com/cyanheads/coingecko-mcp-server#readme","bugs":{"url":"https://github.com/cyanheads/coingecko-mcp-server/issues"},"bin":{"coingecko-mcp-server":"dist/index.js"},"dist":{"shasum":"5a8d246903280fb664fc298177cdb97db37d23b0","tarball":"https://registry.npmjs.org/@cyanheads/coingecko-mcp-server/-/coingecko-mcp-server-0.1.0.tgz","fileCount":77,"integrity":"sha512-rn1A8OGYk7/V2EZct86F5EM1Ktg3Nukib8SVLtbeO3+yugvCGA+m6JaCSBCWXcaVvW36qd/+sjh7r8qbFT/3vA==","signatures":[{"sig":"MEYCIQD53i9GjN+Vb+jB/5Z25rQErt94UFkZKqnronRlTz6qGwIhAI4u6nnbcZ1kGTO9hTEGeqx3FAsBjF5u3ryPi5w9Gr8c","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":322886},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","shasum":"5a8d246903280fb664fc298177cdb97db37d23b0","engines":{"bun":">=1.3.0","node":">=24.0.0"},"mcpName":"io.github.cyanheads/coingecko-mcp-server","scripts":{"test":"vitest run","tree":"bun run scripts/tree.ts","build":"bun run scripts/build.ts","clean":"bun run scripts/clean.ts","start":"node dist/index.js","bundle":"bun run build && npx -y @anthropic-ai/mcpb pack . dist/coingecko-mcp-server.mcpb && bun run scripts/clean-mcpb.ts dist/coingecko-mcp-server.mcpb","format":"biome check --write .","rebuild":"bun run scripts/clean.ts && bun run scripts/build.ts","devcheck":"bun run scripts/devcheck.ts","lint:mcp":"bun run scripts/lint-mcp.ts","start:http":"MCP_TRANSPORT_TYPE=http node dist/index.js","list-skills":"bun run scripts/list-skills.ts","publish-mcp":"mcp-publisher login github -token \"$(security find-generic-password -a \"$USER\" -s mcp-publisher-github-pat -w)\" && mcp-publisher publish","start:stdio":"MCP_TRANSPORT_TYPE=stdio node dist/index.js","audit:refresh":"rm -f bun.lock && bun install && bun audit","format:unsafe":"biome check --write --unsafe .","lint:packaging":"bun run scripts/lint-packaging.ts","release:github":"bun run scripts/release-github.ts","changelog:build":"bun run scripts/build-changelog.ts","changelog:check":"bun run scripts/build-changelog.ts --check"},"_npmUser":{"name":"cyanheads","email":"casey@caseyjhand.com"},"_integrity":"sha512-rn1A8OGYk7/V2EZct86F5EM1Ktg3Nukib8SVLtbeO3+yugvCGA+m6JaCSBCWXcaVvW36qd/+sjh7r8qbFT/3vA==","repository":{"url":"https://github.com/cyanheads/coingecko-mcp-server","type":"git"},"_npmVersion":"10.8.3","description":"Market data for 15,000+ cryptocurrencies — prices, history, trends, and deep coin metadata via CoinGecko.","directories":{},"_nodeVersion":"24.3.0","dependencies":{"zod":"^4.4.3","pino-pretty":"^13.1.3","@cyanheads/mcp-ts-core":"^0.10.6"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"bun@1.3.2","devDependencies":{"ignore":"^7.0.5","vitest":"^4.1.8","depcheck":"^1.4.7","tsc-alias":"^1.8.17","typescript":"^6.0.3","@types/node":"25.9.3","@biomejs/biome":"2.5.0"},"_npmOperationalInternal":{"tmp":"tmp/coingecko-mcp-server_0.1.0_1781372418498_0.6099204903102589","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@cyanheads/coingecko-mcp-server","version":"0.1.1","keywords":["mcp","mcp-server","model-context-protocol","coingecko","cryptocurrency","crypto","bitcoin","ethereum","market-data","defi","typescript","bun","stdio","streamable-http"],"author":{"url":"https://github.com/cyanheads/coingecko-mcp-server#readme","name":"cyanheads","email":"casey@caseyjhand.com"},"license":"Apache-2.0","_id":"@cyanheads/coingecko-mcp-server@0.1.1","maintainers":[{"name":"cyanheads","email":"casey@caseyjhand.com"}],"homepage":"https://github.com/cyanheads/coingecko-mcp-server#readme","bugs":{"url":"https://github.com/cyanheads/coingecko-mcp-server/issues"},"bin":{"coingecko-mcp-server":"dist/index.js"},"dist":{"shasum":"eb9521d04008163cd4487f390dad9c80421e9265","tarball":"https://registry.npmjs.org/@cyanheads/coingecko-mcp-server/-/coingecko-mcp-server-0.1.1.tgz","fileCount":78,"integrity":"sha512-zcXAi8/Hw6QfC6ii5B4iMi50EZ0XwJppwhGpESLsAtuYYYsVyuSZsWCBwqdpGccltEa8I/TE9dW93WsSb6jyWw==","signatures":[{"sig":"MEUCIAKdEFTwaQLal0opj8uN9bzVud9pNo27sNH4xvGWjIp0AiEA+HEjJZLixvS5h1iStOsz+Fjccse5Vmjk6ue3Eku0/8Q=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":323295},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"bun":">=1.3.0","node":">=24.0.0"},"gitHead":"1e6f3b9d7314d0153012033831050ec601569b28","mcpName":"io.github.cyanheads/coingecko-mcp-server","scripts":{"test":"vitest run","tree":"bun run scripts/tree.ts","build":"bun run scripts/build.ts","clean":"bun run scripts/clean.ts","start":"node dist/index.js","bundle":"bun run build && npx -y @anthropic-ai/mcpb pack . dist/coingecko-mcp-server.mcpb && bun run scripts/clean-mcpb.ts dist/coingecko-mcp-server.mcpb","format":"biome check --write .","rebuild":"bun run scripts/clean.ts && bun run scripts/build.ts","devcheck":"bun run scripts/devcheck.ts","lint:mcp":"bun run scripts/lint-mcp.ts","start:http":"MCP_TRANSPORT_TYPE=http node dist/index.js","list-skills":"bun run scripts/list-skills.ts","publish-mcp":"mcp-publisher login github -token \"$(security find-generic-password -a \"$USER\" -s mcp-publisher-github-pat -w)\" && mcp-publisher publish","start:stdio":"MCP_TRANSPORT_TYPE=stdio node dist/index.js","audit:refresh":"rm -f bun.lock && bun install && bun audit","format:unsafe":"biome check --write --unsafe .","lint:packaging":"bun run scripts/lint-packaging.ts","release:github":"bun run scripts/release-github.ts","changelog:build":"bun run scripts/build-changelog.ts","changelog:check":"bun run scripts/build-changelog.ts --check"},"_npmUser":{"name":"cyanheads","email":"casey@caseyjhand.com"},"repository":{"url":"git+https://github.com/cyanheads/coingecko-mcp-server.git","type":"git"},"_npmVersion":"11.12.1","description":"Market data for 15,000+ cryptocurrencies — prices, history, trends, and deep coin metadata via CoinGecko.","directories":{},"_nodeVersion":"26.0.0","dependencies":{"zod":"^4.4.3","pino-pretty":"^13.1.3","@cyanheads/mcp-ts-core":"^0.10.6"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"bun@1.3.2","devDependencies":{"ignore":"^7.0.5","vitest":"^4.1.8","depcheck":"^1.4.7","tsc-alias":"^1.8.17","typescript":"^6.0.3","@types/node":"25.9.3","@biomejs/biome":"2.5.0"},"_npmOperationalInternal":{"tmp":"tmp/coingecko-mcp-server_0.1.1_1781432919794_0.5600343880075147","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@cyanheads/coingecko-mcp-server","version":"0.1.2","keywords":["mcp","mcp-server","model-context-protocol","coingecko","cryptocurrency","crypto","bitcoin","ethereum","market-data","defi","typescript","bun","stdio","streamable-http"],"author":"Casey Hand <casey@caseyjhand.com> (https://caseyjhand.com)","license":"Apache-2.0","_id":"@cyanheads/coingecko-mcp-server@0.1.2","maintainers":[{"name":"cyanheads","email":"casey@caseyjhand.com"}],"homepage":"https://github.com/cyanheads/coingecko-mcp-server#readme","bugs":{"url":"https://github.com/cyanheads/coingecko-mcp-server/issues"},"bin":{"coingecko-mcp-server":"dist/index.js"},"dist":{"shasum":"9b335f99bc685c491ddf76e73cab3e8838ea22d0","tarball":"https://registry.npmjs.org/@cyanheads/coingecko-mcp-server/-/coingecko-mcp-server-0.1.2.tgz","fileCount":79,"integrity":"sha512-7fpVNoXIRHU45DdoSLQLyBaVeH4T7cl3Q8qTblqd+pLfqPXUT6mj+WA0RoYO2tSdgx8CUdQ+yBSWjt2itPGTVw==","signatures":[{"sig":"MEQCICkPeqbN/pDZEOYHcNhUkPm7Xl8Z1wwyG6VpGpMI8crhAiAnpil7expO7P04itBz444NHKUz43FFAj0MijeNnW1aJQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":329695},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","shasum":"9b335f99bc685c491ddf76e73cab3e8838ea22d0","engines":{"bun":">=1.3.0","node":">=24.0.0"},"mcpName":"io.github.cyanheads/coingecko-mcp-server","scripts":{"test":"vitest run","tree":"bun run scripts/tree.ts","build":"bun run scripts/build.ts","clean":"bun run scripts/clean.ts","start":"node dist/index.js","bundle":"bun run build && npx -y @anthropic-ai/mcpb pack . dist/coingecko-mcp-server.mcpb && bun run scripts/clean-mcpb.ts dist/coingecko-mcp-server.mcpb","format":"biome check --write .","rebuild":"bun run scripts/clean.ts && bun run scripts/build.ts","devcheck":"bun run scripts/devcheck.ts","lint:mcp":"bun run scripts/lint-mcp.ts","start:http":"MCP_TRANSPORT_TYPE=http node dist/index.js","list-skills":"bun run scripts/list-skills.ts","publish-mcp":"mcp-publisher login github -token \"$(security find-generic-password -a \"$USER\" -s mcp-publisher-github-pat -w)\" && mcp-publisher publish","start:stdio":"MCP_TRANSPORT_TYPE=stdio node dist/index.js","audit:refresh":"rm -f bun.lock && bun install && bun audit","format:unsafe":"biome check --write --unsafe .","lint:packaging":"bun run scripts/lint-packaging.ts","release:github":"bun run scripts/release-github.ts","changelog:build":"bun run scripts/build-changelog.ts","changelog:check":"bun run scripts/build-changelog.ts --check"},"_npmUser":{"name":"cyanheads","email":"casey@caseyjhand.com"},"_integrity":"sha512-7fpVNoXIRHU45DdoSLQLyBaVeH4T7cl3Q8qTblqd+pLfqPXUT6mj+WA0RoYO2tSdgx8CUdQ+yBSWjt2itPGTVw==","repository":{"url":"git+https://github.com/cyanheads/coingecko-mcp-server.git","type":"git"},"_npmVersion":"10.8.3","description":"Market data for 15,000+ cryptocurrencies — prices, history, trends, and deep coin metadata via CoinGecko.","directories":{},"_nodeVersion":"26.3.0","dependencies":{"zod":"^4.4.3","pino-pretty":"^13.1.3","@cyanheads/mcp-ts-core":"^0.12.3"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"bun@1.4.0","devDependencies":{"ignore":"^7.0.6","vitest":"^4.1.11","depcheck":"^1.4.7","tsc-alias":"^1.9.2","typescript":"^7.0.2","@types/node":"26.2.0","@biomejs/biome":"2.5.9","@socketsecurity/bun-security-scanner":"^1.1.2"},"_npmOperationalInternal":{"tmp":"tmp/coingecko-mcp-server_0.1.2_1787328334361_0.7923842064360207","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"_id":"@cyanheads/coingecko-mcp-server@0.1.3","bin":{"coingecko-mcp-server":"dist/index.js"},"bugs":{"url":"https://github.com/cyanheads/coingecko-mcp-server/issues"},"dist":{"shasum":"dee9a455541e1637970203f6e05c8e1b8cd55376","tarball":"https://registry.npmjs.org/@cyanheads/coingecko-mcp-server/-/coingecko-mcp-server-0.1.3.tgz","fileCount":80,"integrity":"sha512-EvZnhxXqXsdaeDhK4OTO9ulqp1IoZOfxkB/efBLyQewjEORjn66qXGgz+Lk6DI3VHpCqIBI/5MAnggAij+uaTQ==","signatures":[{"sig":"MEUCIHn4YuoSQxIMt1ZEbByxtqI2QpEunt8e8cfSQ1W2pbLgAiEAkgiLfHnaB0iQBEfPTOGsNMW9V0xpNibM3bpUfqokYZQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIENze5Cw77Wa62WCfhmLeKvdGgZ+dhdQysvYSWxFrf5lAiEAw3sUGJ7gyoWeukSZF7t5C8vzSrt+wam6ujuXZ85G6lo="}],"unpackedSize":346374},"main":"dist/index.js","name":"@cyanheads/coingecko-mcp-server","type":"module","types":"dist/index.d.ts","author":"Casey Hand <casey@caseyjhand.com> (https://caseyjhand.com)","shasum":"dee9a455541e1637970203f6e05c8e1b8cd55376","engines":{"bun":">=1.4.0","node":">=24.0.0"},"funding":[{"url":"https://github.com/sponsors/cyanheads","type":"github"},{"url":"https://www.buymeacoffee.com/cyanheads","type":"buy_me_a_coffee"}],"license":"Apache-2.0","mcpName":"io.github.cyanheads/coingecko-mcp-server","scripts":{"test":"vitest run","tree":"bun run scripts/tree.ts","build":"bun run scripts/build.ts","clean":"bun run scripts/clean.ts","start":"node dist/index.js","bundle":"bun run build && npx -y @anthropic-ai/mcpb pack . dist/coingecko-mcp-server.mcpb && bun run scripts/clean-mcpb.ts dist/coingecko-mcp-server.mcpb","format":"biome check --write .","rebuild":"bun run scripts/clean.ts && bun run scripts/build.ts","devcheck":"bun run scripts/devcheck.ts","lint:mcp":"bun run scripts/lint-mcp.ts","audit:fix":"bun audit fix","start:http":"MCP_TRANSPORT_TYPE=http node dist/index.js","list-skills":"bun run scripts/list-skills.ts","publish-mcp":"mcp-publisher login github -token \"$(security find-generic-password -a \"$USER\" -s mcp-publisher-github-pat -w)\" && mcp-publisher publish","start:stdio":"MCP_TRANSPORT_TYPE=stdio node dist/index.js","audit:refresh":"rm -f bun.lock && bun install && bun audit","format:unsafe":"biome check --write --unsafe .","lint:packaging":"bun run scripts/lint-packaging.ts","release:github":"bun run scripts/release-github.ts","changelog:build":"bun run scripts/build-changelog.ts","changelog:check":"bun run scripts/build-changelog.ts --check"},"version":"0.1.3","_npmUser":{"name":"cyanheads","email":"casey@caseyjhand.com"},"homepage":"https://github.com/cyanheads/coingecko-mcp-server#readme","keywords":["mcp","mcp-server","model-context-protocol","coingecko","cryptocurrency","crypto","bitcoin","ethereum","market-data","defi","typescript","bun","stdio","streamable-http"],"_integrity":"sha512-EvZnhxXqXsdaeDhK4OTO9ulqp1IoZOfxkB/efBLyQewjEORjn66qXGgz+Lk6DI3VHpCqIBI/5MAnggAij+uaTQ==","repository":{"url":"git+https://github.com/cyanheads/coingecko-mcp-server.git","type":"git"},"_npmVersion":"10.8.3","description":"Market data for 15,000+ cryptocurrencies — prices, history, trends, and deep coin metadata via CoinGecko.","directories":{},"maintainers":[{"name":"cyanheads","email":"casey@caseyjhand.com"}],"_nodeVersion":"26.3.0","dependencies":{"zod":"^4.6.5","pino-pretty":"^13.1.3","@cyanheads/mcp-ts-core":"^0.13.6"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"bun@1.4.0","devDependencies":{"ignore":"^7.0.9","vitest":"^5.0.1","depcheck":"^1.4.7","tsc-alias":"^1.9.5","typescript":"^7.0.2","@types/node":"26.6.2","@biomejs/biome":"2.5.14","@socketsecurity/bun-security-scanner":"^1.1.2"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/coingecko-mcp-server_0.1.3_1790050416592_0.40582445991159233"}}},"time":{"created":"2026-06-13T17:40:18.331Z","modified":"2026-09-22T04:13:36.896Z","0.1.0":"2026-06-13T17:40:18.643Z","0.1.1":"2026-06-14T10:28:39.934Z","0.1.2":"2026-08-21T16:05:34.505Z","0.1.3":"2026-09-22T04:13:36.719Z"},"bugs":{"url":"https://github.com/cyanheads/coingecko-mcp-server/issues"},"author":"Casey Hand <casey@caseyjhand.com> (https://caseyjhand.com)","license":"Apache-2.0","homepage":"https://github.com/cyanheads/coingecko-mcp-server#readme","keywords":["mcp","mcp-server","model-context-protocol","coingecko","cryptocurrency","crypto","bitcoin","ethereum","market-data","defi","typescript","bun","stdio","streamable-http"],"repository":{"url":"git+https://github.com/cyanheads/coingecko-mcp-server.git","type":"git"},"description":"Market data for 15,000+ cryptocurrencies — prices, history, trends, and deep coin metadata via CoinGecko.","maintainers":[{"name":"cyanheads","email":"casey@caseyjhand.com"}],"readme":"<div align=\"center\">\n  <h1>@cyanheads/coingecko-mcp-server</h1>\n  <p><b>Market data for 15,000+ cryptocurrencies — prices, history, trends, and deep coin metadata via CoinGecko.</b>\n  <div>8 Tools • 2 Resources • 1 Prompt</div>\n  </p>\n</div>\n\n<div align=\"center\">\n\n[![Version](https://img.shields.io/badge/Version-0.1.3-blue.svg?style=flat-square)](./CHANGELOG.md) [![License](https://img.shields.io/badge/License-Apache%202.0-orange.svg?style=flat-square)](./LICENSE) [![Docker](https://img.shields.io/badge/Docker-ghcr.io-2496ED?style=flat-square&logo=docker&logoColor=white)](https://github.com/users/cyanheads/packages/container/package/coingecko-mcp-server) [![MCP SDK](https://img.shields.io/badge/MCP%20SDK-^2.0.0-green.svg?style=flat-square)](https://modelcontextprotocol.io/) [![npm](https://img.shields.io/npm/v/%40cyanheads%2Fcoingecko-mcp-server?style=flat-square&logo=npm&logoColor=white)](https://www.npmjs.com/package/@cyanheads/coingecko-mcp-server) [![TypeScript](https://img.shields.io/badge/TypeScript-^7.0.2-3178C6.svg?style=flat-square)](https://www.typescriptlang.org/) [![Bun](https://img.shields.io/badge/Bun-v1.4.0-blueviolet.svg?style=flat-square)](https://bun.sh/)\n\n</div>\n\n<div align=\"center\">\n\n[![Install in Claude Desktop](https://img.shields.io/badge/Install_in-Claude_Desktop-D97757?style=for-the-badge&logo=anthropic&logoColor=white)](https://github.com/cyanheads/coingecko-mcp-server/releases/latest/download/coingecko-mcp-server.mcpb) [![Install in Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=coingecko-mcp-server&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBjeWFuaGVhZHMvY29pbmdlY2tvLW1jcC1zZXJ2ZXIiXX0=) [![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_Server-0098FF?style=for-the-badge&logo=visualstudiocode&logoColor=white)](https://vscode.dev/redirect?url=vscode:mcp/install?%7B%22name%22%3A%22coingecko-mcp-server%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40cyanheads%2Fcoingecko-mcp-server%22%5D%7D)\n\n[![Framework](https://img.shields.io/badge/Built%20on-@cyanheads/mcp--ts--core-67E8F9?style=flat-square)](https://www.npmjs.com/package/@cyanheads/mcp-ts-core)\n\n</div>\n\n---\n\n## Overview\n\nCryptocurrency 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. Runs as a stdio process or a local Streamable HTTP server.\n\n### Tools\n\n| Tool | Description |\n|:---|:---|\n| `coingecko_search_coins` | Resolve a coin name or ticker symbol to a CoinGecko ID (slug). The required first step before any ID-keyed tool. |\n| `coingecko_get_prices` | Current price and core market stats for one or more coins in one or more currencies. Batch up to 250 slugs; reports unresolved ids in a `missing` field. |\n| `coingecko_list_markets` | Ranked market table — top coins by market cap, volume, or 24h change, optionally filtered to a category. |\n| `coingecko_get_coin` | Deep single-coin profile — description, links, market data, developer activity, community, sentiment. `sections` trims the large record. |\n| `coingecko_get_market_chart` | Historical price, market cap, and volume series. `recent` (last N days, auto-granularity) or `range` (explicit Unix-second window) mode. |\n| `coingecko_get_trending` | Coins trending on CoinGecko in the last 24 hours, by search volume. |\n| `coingecko_get_global` | Global crypto market snapshot — total market cap and volume, BTC/ETH dominance, active counts, ongoing ICOs, 24h change. |\n| `coingecko_list_categories` | Coin categories (`category_id` + display name) — the valid slugs for `coingecko_list_markets`'s `category` filter. |\n\n### Resources\n\n| Resource | Description |\n|:---|:---|\n| `coingecko://coin/{id}` | Deep coin record by slug — same data as `coingecko_get_coin` (full record, USD market figures). |\n| `coingecko://global` | Global crypto market snapshot — same data as `coingecko_get_global`. |\n\nAll 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.\n\n### Prompts\n\n| Prompt | Description |\n|:---|:---|\n| `coingecko_coin_research` | Guides a full single-coin research pass through the search → get_coin → get_market_chart → get_global chain. |\n\n## Capability reference\n\n### `coingecko_search_coins` <sub>tool</sub>\n\n- Tickers are not unique (many coins share `ETH`/`USDC`) — returns ranked candidates with `id`, `symbol`, `name`, and `marketCapRank` to disambiguate\n- Returns the top 25 matches by relevance; `enrichment.truncated` plus `shown`/`cap` disclose when the list is capped\n- An empty result is a normal outcome, not an error — `enrichment.notice` suggests broadening the query\n\n---\n\n### `coingecko_get_prices` <sub>tool</sub>\n\n- Batch up to 250 slugs across one or more currencies (`vs_currencies` defaults to `[\"usd\"]`) in a single call\n- One row per `(id, currency)` that returned a price; market cap, 24h volume, and 24h change are optional per row\n- A wrong or unknown slug returns a silent empty response upstream rather than an error — `missing` lists unresolved ids so a typo reads as \"unresolved,\" not \"nonexistent\"\n- Unsupported currency codes are silently dropped upstream and surfaced via `enrichment.notice`\n- `lastUpdatedAtUnixSec`, when present, is Unix seconds — `coingecko_get_market_chart`'s point timestamps are milliseconds\n- Throws `all_missing` only when no requested id resolves\n\n---\n\n### `coingecko_list_markets` <sub>tool</sub>\n\n- Sort by market cap, volume, or 24h price change, ascending or descending, via `order`\n- Optional `category` filter — pass a `categoryId` from `coingecko_list_categories`\n- Pagination via `page` and `per_page` (default 50, max 250 rows); `enrichment.truncated` discloses when a page fills\n- Per-coin fields include price, cap, volume, 1h/24h/7d change, supply, and ATH/ATL\n- Throws `unknown_category` when a category filter returns empty — CoinGecko returns empty rather than erroring on an unrecognized slug\n\n---\n\n### `coingecko_get_coin` <sub>tool</sub>\n\n- Six sections — `profile`, `market`, `links`, `developer`, `community`, `sentiment`; `sections` trims the response to just what's needed (the full record is large)\n- Market figures are denominated in `vs_currency` (defaults to `usd`)\n- `profile.categories` are display names (e.g. `\"Layer 1 (L1)\"`) — distinct from the `categoryId` slugs `coingecko_list_categories` returns\n- Sparse upstream fields are omitted rather than fabricated\n- Throws `coin_not_found` when the slug isn't recognized upstream\n\n---\n\n### `coingecko_get_market_chart` <sub>tool</sub>\n\n- `recent` mode: last N days (or `\"max\"`); granularity auto-scales by span — ≤1 day → ~5-min, 2–90 → hourly, >90 → daily\n- `range` mode: an explicit window via `from`/`to` as Unix seconds\n- Returns timestamped point arrays for price, market cap, and volume in `vs_currency` (defaults to `usd`)\n- Point timestamps are Unix milliseconds — `coingecko_get_prices`'s `lastUpdatedAtUnixSec` is seconds\n- Throws `invalid_range` on a mode/parameter mismatch, `coin_not_found` when the slug isn't recognized\n\n---\n\n### `coingecko_get_trending` <sub>tool</sub>\n\n- No parameters — 24-hour trending coins by search volume, each with `marketCapRank`, `priceUsd`, `priceBtc`, and `priceChangePercentage24hUsd` when available\n- Upstream reports market cap and volume as pre-formatted display strings, not numbers — those fields are omitted rather than presented as numeric data\n- `nftCount` reports the trending-NFT count upstream also returns; NFT detail itself isn't surfaced\n\n---\n\n### `coingecko_get_global` <sub>tool</sub>\n\n- No coin id needed — one call for the macro snapshot\n- `vs_currency` (default `usd`) scopes only total market cap and volume; dominance and the 24h change percentages are always USD-denominated upstream\n- 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\n- Returns active-cryptocurrency and active-market counts, ongoing ICO count, and a Unix-second snapshot timestamp\n\n---\n\n### `coingecko_list_categories` <sub>tool</sub>\n\n- Optional `name_contains` filters the ~800-category list locally by whitespace-separated tokens — case- and punctuation-insensitive, every token must appear in the name\n- `enrichment.totalCount` reports the total category count before any local filter\n- Returned `categoryId` values are what `coingecko_list_markets`'s `category` param expects\n- A filter that matches nothing returns `enrichment.notice` suggesting an unfiltered browse instead\n\n---\n\n### `coingecko://coin/{id}` <sub>resource</sub>\n\n- Same data as `coingecko_get_coin`'s full record, always denominated in USD\n- `{id}` is a CoinGecko slug (e.g. `\"bitcoin\"`) — resolve tickers with `coingecko_search_coins`\n- Throws `coin_not_found` when the slug isn't recognized upstream\n\n---\n\n### `coingecko://global` <sub>resource</sub>\n\n- Same data as `coingecko_get_global`, always denominated in USD\n- No parameters\n\n---\n\n### `coingecko_coin_research` <sub>prompt</sub>\n\n- Argument: `coin` required — a name, ticker, or CoinGecko slug\n- Returns an assistant framing message plus a user message that walks the search → get_coin → get_market_chart → get_global chain\n\n## Features\n\nBuilt on [`@cyanheads/mcp-ts-core`](https://github.com/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.\n\nCoinGecko-specific:\n\n- Type-safe client for the CoinGecko v3 REST API, with one service method per endpoint\n- 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\n- Calibrated retry/backoff on the rate-limited public tier — 429s, 5xx, and timeouts retry; `Retry-After` is honored\n- Three distinct upstream error shapes mapped to typed reasons (404 → `coin_not_found`, 429 → `rate_limited`, the `/simple/price` silent miss handled as a `missing` field, not an error)\n\nAgent-friendly output:\n\n- Search-before-query enforced through descriptions — every ID-keyed tool states slugs-not-tickers and points back to `coingecko_search_coins`\n- Provenance and graceful degradation — `coingecko_get_prices` reports unresolved ids and dropped currencies instead of failing; truncation and applied filters are disclosed via enrichment\n- Units made explicit — timestamp fields document seconds vs. milliseconds so callers don't misread them\n- Required CoinGecko attribution ships on every tool and resource output; the research prompt instructs the agent to attribute its findings the same way\n\n## Getting started\n\nAdd 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](#configuration)).\n\n```json\n{\n  \"mcpServers\": {\n    \"coingecko-mcp-server\": {\n      \"type\": \"stdio\",\n      \"command\": \"bunx\",\n      \"args\": [\"@cyanheads/coingecko-mcp-server@latest\"],\n      \"env\": {\n        \"MCP_TRANSPORT_TYPE\": \"stdio\",\n        \"MCP_LOG_LEVEL\": \"info\"\n      }\n    }\n  }\n}\n```\n\nOr with npx (no Bun required):\n\n```json\n{\n  \"mcpServers\": {\n    \"coingecko-mcp-server\": {\n      \"type\": \"stdio\",\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@cyanheads/coingecko-mcp-server@latest\"],\n      \"env\": {\n        \"MCP_TRANSPORT_TYPE\": \"stdio\",\n        \"MCP_LOG_LEVEL\": \"info\"\n      }\n    }\n  }\n}\n```\n\nOr with Docker:\n\n```json\n{\n  \"mcpServers\": {\n    \"coingecko-mcp-server\": {\n      \"type\": \"stdio\",\n      \"command\": \"docker\",\n      \"args\": [\n        \"run\", \"-i\", \"--rm\",\n        \"-e\", \"MCP_TRANSPORT_TYPE=stdio\",\n        \"ghcr.io/cyanheads/coingecko-mcp-server:latest\"\n      ]\n    }\n  }\n}\n```\n\nTo attach a CoinGecko Demo key, add `\"COINGECKO_API_KEY\": \"your-demo-key\"` to the `env` block (or `-e COINGECKO_API_KEY=your-demo-key` for Docker).\n\nFor Streamable HTTP, set the transport and start the server:\n\n```sh\nMCP_TRANSPORT_TYPE=http MCP_HTTP_PORT=3010 bun run start:http\n# Server listens at http://localhost:3010/mcp\n```\n\n### Prerequisites\n\n- [Bun v1.4.0](https://bun.sh/) or higher (or Node.js v24+).\n- No account or API key required to run. Optionally, a free [CoinGecko Demo API key](https://www.coingecko.com/en/api/pricing) for a higher rate ceiling (10k calls/month, 100 req/min) over the shared keyless public pool.\n\n### Installation\n\n1. **Clone the repository:**\n\n```sh\ngit clone https://github.com/cyanheads/coingecko-mcp-server.git\n```\n\n2. **Navigate into the directory:**\n\n```sh\ncd coingecko-mcp-server\n```\n\n3. **Install dependencies:**\n\n```sh\nbun install\n```\n\n4. **Configure environment (optional):**\n\n```sh\ncp .env.example .env\n# the server runs with no .env at all; edit only to set COINGECKO_API_KEY\n```\n\n## Configuration\n\nThe server runs with zero configuration. The one server-specific variable is optional:\n\n| Variable | Description | Default |\n|:---|:---|:---|\n| `COINGECKO_API_KEY` | Optional CoinGecko **Demo** API key. When set, it is sent as the `x-cg-demo-api-key` header for the dedicated Demo tier (10k/mo, 100 req/min); the base URL is unchanged. Absent → keyless public tier (shared, IP-throttled). | — |\n| `MCP_TRANSPORT_TYPE` | Transport: `stdio` or `http`. | `stdio` |\n| `MCP_HTTP_PORT` | Port for the HTTP server. | `3010` |\n| `MCP_HTTP_ENDPOINT_PATH` | HTTP endpoint path. | `/mcp` |\n| `MCP_SESSION_MODE` | HTTP session mode: `stateless`, `stateful`, or `auto` (resolves to `stateful`). The server declares `stateless` in code; an explicit value overrides it, while an empty or unsubstituted `${…}` value falls through to `stateless`. | `stateless` |\n| `MCP_AUTH_MODE` | Auth mode: `none`, `jwt`, or `oauth`. | `none` |\n| `MCP_LOG_LEVEL` | Log level (RFC 5424). | `info` |\n| `LOGS_DIR` | Directory for log files (Node.js only). | `<project-root>/logs` |\n| `STORAGE_PROVIDER_TYPE` | Storage backend. | `in-memory` |\n| `OTEL_ENABLED` | Enable [OpenTelemetry instrumentation](https://github.com/cyanheads/mcp-ts-core/tree/main/docs/telemetry) (spans, metrics, completion logs). | `false` |\n\nSee [`.env.example`](./.env.example) for the full list of optional overrides.\n\n**Rate limits and freshness.** The keyless public tier shares an IP-throttled pool, so bursty multi-tool workflows can hit `429`s under light load; the server backs off and retries, but cannot raise the ceiling — a free Demo key does. CoinGecko data refreshes roughly every 60 seconds and is not tick-level.\n\n## Running the server\n\n### Local development\n\n- **Build and run:**\n\n  ```sh\n  # One-time build\n  bun run rebuild\n\n  # Run the built server\n  bun run start:stdio\n  # or\n  bun run start:http\n  ```\n\n- **Run checks and tests:**\n\n  ```sh\n  bun run devcheck   # Lint, format, typecheck, security\n  bun run test       # Vitest test suite\n  bun run lint:mcp   # Validate MCP definitions against spec\n  ```\n\n### Docker\n\n```sh\ndocker build -t coingecko-mcp-server .\ndocker run --rm -e MCP_TRANSPORT_TYPE=http -p 3010:3010 coingecko-mcp-server\n```\n\nThe Dockerfile defaults to HTTP transport, stateless session mode, and logs to `/var/log/coingecko-mcp-server`. OpenTelemetry peer dependencies are installed by default — build with `--build-arg OTEL_ENABLED=false` to omit them.\n\n## Project structure\n\n| Directory | Purpose |\n|:---|:---|\n| `src/index.ts` | `createApp()` entry point — registers tools/resources/prompts and inits the CoinGecko service. |\n| `src/config` | Server-specific environment variable parsing and validation with Zod. |\n| `src/mcp-server/tools` | Tool definitions (`*.tool.ts`). |\n| `src/mcp-server/resources` | Resource definitions (`*.resource.ts`). |\n| `src/mcp-server/prompts` | Prompt definitions (`*.prompt.ts`). |\n| `src/services/coingecko` | CoinGecko v3 REST API service — HTTP client, retry/error mapping, response normalization, domain types. |\n| `tests/` | Unit and integration tests mirroring `src/`. |\n\n## Development guide\n\nSee [`CLAUDE.md`/`AGENTS.md`](./CLAUDE.md) for development guidelines and architectural rules. The short version:\n\n- Handlers throw, framework catches — no `try/catch` in tool logic\n- Use `ctx.log` for request-scoped logging, `ctx.state` for tenant-scoped storage\n- Register new tools and resources via the `createApp()` arrays in `src/index.ts`\n- Wrap external API calls: validate raw → normalize to domain type → return output schema; never fabricate missing fields\n\n## Contributing\n\nIssues are welcome. Run checks and tests before submitting:\n\n```sh\nbun run devcheck\nbun run test\n```\n\n## License\n\nApache-2.0 — see [LICENSE](./LICENSE) for details.\n","readmeFilename":"README.md"}