MCP server providing AI-accessible tools for cryptocurrency market data, pricing, trending coins, NFTs, derivatives, on-chain data, and news from the CoinGecko API
CoinGecko server has 11 well-named tools with clear, action-verb prefixes (get_, search_). Descriptions are present and contextual (avg ~120 chars), exceeding the 10-char minimum. Input schemas are visible and typed (string, integer, array, boolean). However, output schemas are completely undocumented, no response structure is defined anywhere in the source. Parameter descriptions lack detail on constraints (e.g., no min/max for limits, no enum for vsCurrency values). Error handling is absent from the code, no guidance on what happens when a coin ID is invalid or an API call fails. Security is reasonable (read-only operations, no secrets in params), but composition could be tighter: search_onchain_pools and get_onchain_token_prices are closely related and could benefit from clearer chaining guidance.
Search CoinGecko for coins, NFTs, exchanges, and categories by name or ticker. Use this first when the user mentions a coin by ticker or partial name.
List coin sector categories (DeFi, gaming, L1, L2, etc.) with aggregate market data.
Get current prices for one or more coins in a quote currency. Useful when you know coin ids like "bitcoin" or "ethereum" and want the live price.
Get recent crypto news (and guides when filtered by coin) aggregated from 100+ publishers. Use when the user asks "what's the latest news on X?". Requires a paid CoinGecko plan.
List current derivative tickers (futures, perpetuals).
Get detail for one NFT collection by its CoinGecko id.
Output schemas completely undocumented. No response structure defined for any tool. LLMs cannot plan downstream calls or extract required fields without guessing.
Parameter constraints missing. 'limit' and 'maxResults' lack min/max bounds; 'vsCurrency' lacks enum values (usd, eur, gbp, etc.). LLMs will pass invalid values.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 56 | 2026-07-28+ | v2 |
Get on-chain token prices in USD by contract address. Use for tokens not listed on CoinGecko's main aggregator.
Get the top coins ranked by market capitalization. Use for overview-style questions about the market.
List the top wallet holders of an on-chain token by rank, balance, and percentage of supply. Set includePnl=true to also get each holder's average buy price and realized/unrealized PnL. Requires a paid CoinGecko plan.
Get currently trending coins, NFT collections, and categories. Use when the user asks "what's hot" / "what's trending".
Search DEX liquidity pools by name / symbol / contract. Filter by network id (e.g. "eth", "bsc") optionally.
No error handling or recovery guidance. Code does not show what happens when a coin ID is invalid, API rate-limited, or network fails. LLMs receive no actionable error messages.
Onchain tools (search_onchain_pools, get_onchain_token_prices) lack chaining guidance. No documentation of which fields from one tool feed into the next, forcing discovery detours.
Parameter descriptions are generic. 'maxResults' and 'limit' lack guidance on typical values, performance impact, or context window implications. Descriptions should explain when to use each.