Skip to content
Market cap $2.72T +1.5%BTC dominance 59.7%Market flat

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 →