io.github.cyanheads/coingecko-mcp-server
NPM · @CYANHEADS/COINGECKO-MCP-SERVER · SCANNED AUG 7
Crypto market data via CoinGecko — prices, markets, history, trending, and deep coin metadata.
Available components
How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score →
Supply Chain Security86
- No malware found by supply-chain analysis.Pass
- Known CVEs were checked across the 125 of 132 dependencies we could resolve, so this covers what we could see, not the whole tree.Partial
- No install/post-install scripts declared.Pass
- Dependency health was assessed across the 125 of 132 dependencies we could resolve, so this covers what we could see, not the whole tree. View diagnostics → Partial
Provenance & Transparency45
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
- Clear OSI-approved license (Apache-2.0).Pass
- Actively maintained (last published 53 days ago).Pass
- Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail
Schema Quality & AI Usability82
- 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Pass
- AI-judged instruction clarity (excellent).Pass
- Context-footprint check failed: tool/resource definitions use about 1754 tokens (~159/item across 11 items; 8 tools + 3 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management0
- Stability not yet verified: not enough scan history yet (needs a 30-day window).Unverified
Tool Coverage100
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 100% of tool parameters carry a description.Pass
- Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Unverified: 1 category
A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.
Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.
npm · @cyanheads/coingecko-mcp-server
claude mcp add cyanheads-coingecko-mcp-server -- npx -y @cyanheads/coingecko-mcp-server
codex mcp add cyanheads-coingecko-mcp-server -- npx -y @cyanheads/coingecko-mcp-server
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"cyanheads-coingecko-mcp-server": {
"type": "local",
"command": [
"npx",
"-y",
"@cyanheads/coingecko-mcp-server"
],
"enabled": true
}
}
} openclaw mcp add cyanheads-coingecko-mcp-server --command npx --arg -y --arg @cyanheads/coingecko-mcp-server
mcp_servers:
cyanheads-coingecko-mcp-server:
command: "npx"
args: ["-y", "@cyanheads/coingecko-mcp-server"] {
"mcpServers": {
"cyanheads-coingecko-mcp-server": {
"command": "npx",
"args": [
"-y",
"@cyanheads/coingecko-mcp-server"
]
}
}
} Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 6 Aug 26 +31
- Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window). security
- Schema quality: unverified → 100 ▲ functional
- MCP protocol: unverified → pass ▲ functional
- Tool coverage: unverified → 100 ▲ functional
- First check of Tool coverage: 100 functional
- First check of Tool coverage: 100 functional
- First check of Schema quality: fail functional
- First check of Schema quality: excellent functional
- First check of Schema quality: fail functional
- 2 Aug 26 +30
- Provenance: unverified → fail ▼ security
- Install scripts: unverified → pass ▲ security
- Known CVEs: unverified → partial ▲ security
- Malware scan: unverified → pass ▲ security
- Stability: Stability not yet verified: our sandbox run of this package did not complete, so we have no schema to compare. security
- Security disclosure: fail → unverified ▼ functional
- Maintenance: unverified → pass ▲ functional
- License: unverified → pass ▲ functional
- Dependency health: unverified → partial ▲ functional
- Schema quality: Schema quality not yet verified: our sandbox run of this package did not complete, so we have no schema to assess. functional
- Capabilities: Protocol version not yet verified: our sandbox run of this package did not complete, so we never saw its MCP handshake. functional
- Tool coverage: Tool coverage not yet verified: our sandbox run of this package did not complete, so we have no tool definitions to assess. functional
- Licence: Apache-2.0 functional
- 1 Aug 26 −10
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 31 Jul 26 −10
- Provenance: unverified → fail ▼ security
- Malware scan: pass → unverified ▼ security
- Install scripts: unverified → pass ▲ security
- Dependency health: partial → unverified ▼ functional
- License: unverified → pass ▲ functional
- Maintenance: unverified → pass ▲ functional
- Schema quality: Schema quality not yet verified: our sandbox run of this package did not complete, so we have no schema to assess. functional
- Tool coverage: Tool coverage not yet verified: our sandbox run of this package did not complete, so we have no tool definitions to assess. functional
- Licence: Apache-2.0 functional
- 29 Jul 26 +1
- Dependency health: unverified → partial ▲ functional
- Tool coverage: Tool coverage not yet verified: we do not have a sandbox capture of the tool definitions this version of the package serves yet. functional
- Schema quality: Schema quality not yet verified: we do not have a sandbox capture of the MCP schema this version of the package serves yet. functional
- 27 Jul 26 24
First indexed and scored.
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 7 Aug 2026 · Analysed npm/@cyanheads/[email protected]
Provenance No attestation
The registry publishes no build provenance for this version, so there is nothing to verify.
| Result | No attestation |
|---|---|
| Ecosystem | npm |
Dependencies 125 packages
| Packages resolved | 125 |
|---|---|
| Deprecated | 125 |
| Stale | 39 |
| Tree resolution | Partial |
The dependency tree was only partially resolved, so these counts may be incomplete.
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.
coingecko_get_coin coingecko-mcp-server: get coin ~240
Deep profile for a single coin: description, categories, genesis date, homepage/whitepaper/repo/social links, full market data (price, cap, supply, ATH/ATL, multi-window price change), developer activity (GitHub stars/forks/commits), community stats, and sentiment vote split. The full picture for "tell me everything about Ethereum". The id must be a CoinGecko slug (resolve tickers with coingecko_search_coins). Use sections to fetch only part of the large record. Note: categories here are display names (e.g. "Layer 1 (L1)"), not the category_id slugs from coingecko_list_categories.
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | yes | CoinGecko slug (e.g. "ethereum"). Not a ticker — resolve with coingecko_search_coins. |
| sections | array | – | Subset of sections to return: profile, market, links, developer, community, sentiment. Omit for all sections. |
| vs_currency | string | – | Currency for the market-data figures (price, cap, ATH/ATL). Single currency; defaults to "usd". |
| Name | Type | Req | Description |
|---|---|---|---|
| attribution | string | yes | Required data-source attribution. |
| community | object | – | Community stats (CoinGecko no longer returns Twitter follower counts). Present when the community section is requested. |
| developer | object | – | Developer activity. Present when the developer section is requested. |
| id | string | yes | CoinGecko slug. |
| links | object | – | Official and social links. Present when the links section is requested. |
| market | object | – | Market data in vs_currency. Present when the market section is requested. |
| name | string | yes | Display name. |
| profile | object | – | Identity and descriptive metadata. Present when the profile section is requested. |
| sentiment | object | – | Sentiment vote split. Present when the sentiment section is requested. |
| symbol | string | yes | Ticker symbol. |
No examples provided.
coingecko_get_global coingecko-mcp-server: get global ~114
Global crypto market snapshot: total market cap and 24h volume (in a chosen currency), BTC/ETH dominance, active-coin and active-market counts, ongoing ICOs, and 24h market-cap and volume change. One call for the macro picture — no coin id needed.
| Name | Type | Req | Description |
|---|---|---|---|
| vs_currency | string | – | Currency for total market cap and volume (e.g. "usd", "eur", "btc"). Defaults to "usd". Dominance and the change percentages are always USD-denominated upstream. |
| Name | Type | Req | Description |
|---|---|---|---|
| activeCryptocurrencies | number | yes | Count of active cryptocurrencies tracked. |
| attribution | string | yes | Required data-source attribution. |
| btcDominance | number | yes | Bitcoin share of total market cap, as a percentage. |
| ethDominance | number | yes | Ethereum share of total market cap, as a percentage. |
| marketCapChangePercentage24h | number | yes | 24-hour change in total market cap, as a percentage (always USD-denominated). |
| markets | number | yes | Count of active markets (exchanges/pairs) tracked. |
| ongoingIcos | number | yes | Count of ongoing ICOs. |
| totalMarketCap | number | yes | Total crypto market capitalization in vs_currency. |
| totalVolume24h | number | yes | Total 24-hour trading volume in vs_currency. |
| updatedAtUnixSec | number | yes | Snapshot time as a Unix timestamp in seconds. |
| volumeChangePercentage24h | number | yes | 24-hour change in total volume, as a percentage (always USD-denominated). |
No examples provided.
coingecko_get_market_chart coingecko-mcp-server: get market chart ~280
Historical price, market cap, and volume time series for a coin. Two modes: recent (last N days; granularity auto-scales — ≤1 day → ~5-min, 2–90 → hourly, >90 → daily) or range (explicit Unix-second from/to). Returns timestamped point arrays. Use for trend/charting questions, not the current snapshot (use coingecko_get_prices for that). The id must be a CoinGecko slug (resolve tickers with coingecko_search_coins). Chart timestamps are milliseconds.
| Name | Type | Req | Description |
|---|---|---|---|
| days | – | – | recent mode: number of days back, or "max" for full history. Required when mode=recent. |
| from | integer | – | range mode: start time as a Unix timestamp in SECONDS. Required when mode=range. |
| id | string | yes | CoinGecko slug (e.g. "bitcoin"). Not a ticker — resolve with coingecko_search_coins. |
| mode | string | – | recent: last N days (use days). range: explicit window (use from and to as Unix seconds). |
| to | integer | – | range mode: end time as a Unix timestamp in SECONDS. Required when mode=range. |
| vs_currency | string | – | Currency to denominate the series in. Single currency; defaults to "usd". |
| Name | Type | Req | Description |
|---|---|---|---|
| attribution | string | yes | Required data-source attribution. |
| granularity | string | yes | Point spacing CoinGecko applied for this span (computed from the requested range). |
| id | string | yes | CoinGecko slug the series is for. |
| marketCaps | array | yes | Market-cap series over the same window. |
| pointCount | number | yes | Number of price points returned. |
| prices | array | yes | Price series. Data provided by CoinGecko. |
| volumes | array | yes | Volume series over the same window. |
| vsCurrency | string | yes | Currency the series is denominated in. |
No examples provided.
coingecko_get_prices coingecko-mcp-server: get prices ~205
Current price and core market stats (market cap, 24h volume, 24h change) for one or more coins in one or more fiat/crypto currencies. Batch-friendly — pass a whole portfolio in one call (up to 250 ids). IDs must be CoinGecko slugs (bitcoin, ethereum), not tickers; resolve unknown tickers with coingecko_search_coins first. Any requested ids that returned no data are reported in the missing field (a wrong slug yields a silent upstream miss, not an error), so a typo reads as "unresolved", not "nonexistent".
| Name | Type | Req | Description |
|---|---|---|---|
| ids | array | yes | CoinGecko slugs to price (e.g. ["bitcoin","ethereum"]). Not tickers — resolve with coingecko_search_coins. Up to 250 per call. |
| vs_currencies | array | – | Currency codes to price against (e.g. ["usd","eur","btc"]). Defaults to ["usd"]. |
| Name | Type | Req | Description |
|---|---|---|---|
| attribution | string | yes | Required data-source attribution. |
| lastUpdatedAtUnixSec | number | – | Upstream last-updated time as a Unix timestamp in seconds (note: market-chart timestamps are milliseconds). |
| missing | array | yes | Requested ids absent from the response (unknown slug or upstream silent miss). Re-resolve these with coingecko_search_coins. Empty when all ids resolved. |
| notice | string | – | Guidance when some requested ids returned no data — lists the missing ids and how to recover. |
| prices | array | yes | One row per (id, currency) that returned a price. Data provided by CoinGecko. |
No examples provided.
coingecko_get_trending coingecko-mcp-server: get trending ~88
Coins trending on CoinGecko in the last 24 hours, by search volume — a heartbeat for "what's hot in crypto right now". No parameters. Returns trending coins with rank, USD price, and 24h change. (Upstream reports market cap and volume as pre-formatted display strings, not numbers, so those are omitted rather than presented as numeric data.)
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| attribution | string | yes | Required data-source attribution. |
| coins | array | yes | Trending coins ranked by CoinGecko search volume. Data provided by CoinGecko. |
| nftCount | number | yes | Number of trending NFTs upstream also reported (detail not surfaced by this tool). |
No examples provided.
coingecko_list_categories coingecko-mcp-server: list categories ~132
List CoinGecko's coin categories (category_id + display name) — the valid slugs for coingecko_list_markets's category filter. ~800 categories; pass name_contains to filter the list locally by name (e.g. "defi", "layer 1", "gaming") with strict token matching, instead of scanning all of them. Use the returned category_id exactly when filtering markets.
| Name | Type | Req | Description |
|---|---|---|---|
| name_contains | string | – | Local name filter — every whitespace-separated token must appear in the category display name (case-insensitive, punctuation-insensitive). Omit to return the full list. |
| Name | Type | Req | Description |
|---|---|---|---|
| attribution | string | yes | Required data-source attribution. |
| categories | array | yes | Matching categories (full list when no filter). Data provided by CoinGecko. |
| notice | string | – | Guidance when the filter matched nothing — suggests browsing unfiltered. |
| totalCount | number | yes | Total categories available upstream before any local filter. |
No examples provided.
coingecko_list_markets coingecko-mcp-server: list markets ~239
Ranked market table — top coins sorted by market cap, volume, or 24h price change, optionally filtered to a category. The entry point for "top 20 DeFi coins" or "biggest gainers today". Returns standard market fields per coin (price, cap, volume, supply, 24h/1h/7d change, ATH/ATL). Discover valid category slugs with coingecko_list_categories and pass the category_id exactly.
| Name | Type | Req | Description |
|---|---|---|---|
| category | string | – | Restrict to a category slug from coingecko_list_categories (e.g. "layer-1", "decentralized-finance-defi"). Omit for all coins. |
| order | string | – | Sort order. Use price_change_percentage_24h_desc for top gainers, _asc for top losers. |
| page | integer | – | 1-based page number for paging beyond per_page rows. |
| per_page | integer | – | Rows per page (max 250). |
| vs_currency | string | – | Currency to denominate the table in (e.g. "usd", "eur", "btc"). Single currency. |
| Name | Type | Req | Description |
|---|---|---|---|
| appliedCategory | string | – | Category slug applied, when filtered. |
| appliedOrder | string | yes | Sort order applied. |
| attribution | string | yes | Required data-source attribution. |
| cap | number | – | The per_page cap applied. Present only when the page is full. |
| coins | array | yes | Ranked market rows for this page. Data provided by CoinGecko. |
| shown | number | – | Rows returned on this page. Present only when the page is full. |
| truncated | boolean | – | True when the page filled to per_page (more rows likely on the next page). Present only when the page is full. |
No examples provided.
coingecko_search_coins coingecko-mcp-server: search coins ~128
Resolve a coin name or ticker symbol to a CoinGecko ID (slug). The required first step before any ID-keyed tool — CoinGecko keys data by slug (bitcoin, ethereum), not ticker (BTC, ETH), and tickers are not unique (many coins share ETH/USDC). Returns ranked matches with id, symbol, name, and market_cap_rank to disambiguate; pick the intended coin from the ranked candidates.
| Name | Type | Req | Description |
|---|---|---|---|
| query | string | yes | Coin name or ticker symbol to resolve (e.g. "bitcoin", "ETH", "solana"). |
| Name | Type | Req | Description |
|---|---|---|---|
| attribution | string | yes | Required data-source attribution. |
| cap | number | – | The cap applied to the candidate list. Present only when capped. |
| coins | array | yes | Ranked slug candidates (top 25 by relevance). Data provided by CoinGecko. |
| notice | string | – | Guidance when nothing matched — echoes the query and suggests how to broaden. |
| shown | number | – | Number of candidates returned. Present only when capped. |
| truncated | boolean | – | True when the candidate list was capped at the limit. Present only when capped. |
No examples provided.