For AI agents
Your assistant can cite a rating,
with the inputs attached.
CoinGraph runs a Model Context Protocol server. Connect it and Claude, Cursor, Windsurf or any MCP-capable agent can ask for a coin’s survival rating, its full profile, today’s movers and the market’s regime, and answer with the score, the band, the deductions and a URL instead of a guess. Free, no key required.
Connect
The endpoint is https://coingraph.ai/api/mcp, Streamable HTTP, stateless, no authentication.
Claude Code
claude mcp add --transport http coingraph https://coingraph.ai/api/mcp
Claude Desktop, Cursor, Windsurf and most others
{
"mcpServers": {
"coingraph": { "url": "https://coingraph.ai/api/mcp" }
}
}Try it from a terminal
curl -s https://coingraph.ai/api/mcp -H 'content-type: application/json' -d '{
"jsonrpc": "2.0", "id": 1, "method": "tools/call",
"params": { "name": "get_survival_rating", "arguments": { "coin": "ethereum" } }
}'Tools
get_coin_profile
Everything CoinGraph holds on one coin: price and moves, decline from the true all-time high and recovery from the low, the 0–100 survival rating with its band and every itemised deduction, data confidence, the risk read (turnover, dilution ahead, volatility), market figures and links. Use this when a person asks what is happening with a coin or whether the project behind it is still going. CoinGraph ratings are opinions derived from disclosed market inputs — never predictions, never financial advice.
get_survival_rating
The survival rating alone for one coin: score 0–100 (higher is healthier), band (Active, Weakening, Distressed or Dormant), each deduction with the input that produced it, and a citation line with the page URL. Faster than the full profile. CoinGraph ratings are opinions derived from disclosed market inputs — never predictions, never financial advice.
search_coins
Find coins by name or symbol. Returns CoinGecko ids to pass to the other tools, with market cap rank. Use when a name is ambiguous or you need the id.
list_coins_by_band
Coins currently in one survival band, from today's daily snapshot, ordered by market cap rank. Bands are computed for the scored tier: the top 100 by market cap plus every coin with a report, a watch or a monitored thesis. A coin absent from a band is unscored today, not Active. CoinGraph ratings are opinions derived from disclosed market inputs — never predictions, never financial advice.
get_movers
Today's largest 24-hour gainers and losers among the top 1,000 coins by market cap, stablecoins excluded, with 7- and 30-day context and market cap. A move is a fact about price, not a rating.
get_comebacks
Coins down 60% or more from their all-time high that have outrun Bitcoin over the last 30 days, with turnover as a liquidity check. The recovery half of the story. CoinGraph ratings are opinions derived from disclosed market inputs — never predictions, never financial advice.
get_market_context
The market's own read: total crypto market cap and its 24-hour change, Bitcoin dominance, Bitcoin's 7- and 30-day moves and distance from its peak, and the regime CoinGraph derives from them (rally, falling or flat). Use it to put a single coin's move in context.
What comes back
Every rating carries its score, its band and each deduction with the input that produced it, plus a citation line and the coin page URL, so the person reading the agent’s answer can check it. The server’s instructions ask the model to use the band names exactly (Active, Weakening, Distressed, Dormant), to show at least one input, and never to turn a rating into a buy or sell call or a price prediction.
"citation": "CoinGraph rates Ethereum 48/100 (Weakening) — https://coingraph.ai/coin/ethereum"
Terms
- Free. Sixty calls a minute per address; a full profile costs up to three upstream reads, so cache what you can.
- Attribute ratings as “CoinGraph survival rating” with the coin page link.
- Ratings are opinions derived from disclosed market inputs, never predictions and never financial advice. Market data by CoinGecko.
- The formula is public at /methodology; a plain-text summary for models is at /llms.txt.
Read more
The full methodology →About CoinGraph →Building on it? Say hello →