MCP server
Tools
22 tools: twelve that mirror the REST API and one per agent. Inputs below are generated from the live server definition.
Note
{ object, id, as_of, data, sources }. Errors come back as a tool error with the same { error: { code, message } } body.Find and understand #
Read-only tools. Safe to call freely.
search_tokens #
Find a token. With no input, lists the 100 tokens CoinGraph tracks with price, 1h and 24h change, open signals and the latest headline. With `query`, searches 21,000+ tokens by name, symbol or contract address and says whether each one is tracked. Use this first to get the token id.
Inputs
querystringoptionalName, symbol or contract address to search for. Leave empty to list the tracked tokens
get_token_snapshot #
Everything CoinGraph knows about a token right now, in one answer: price and market data, liquidity and order-book depth, futures (open interest, funding, long/short, liquidations), onchain flows to and from exchanges, large transfers, exchange reserves, supply, contract security (honeypot, mint/freeze powers, taxes), news, TVL, developer activity, open signals and the latest brief. Each part says its source and age. Pass `sections` to get only some parts.
Inputs
tokenstringrequiredThe token: a CoinGecko id (cardano, chainlink, solana), a symbol (BTC) or a contract addresssectionsstringoptionalOptional comma list of parts: identity, market, liquidity, derivatives, onchain, supply, security, context, signals, brief. Default: all
get_token_timeline #
What happened to a token over time. Charts: price, 1-minute candles, open interest, funding, long/short ratios, exchange net flow, exchange reserves and TVL. Events: large transfers, liquidations, signals, headlines and briefs, each with a timestamp. Default window: last 24 hours of events and 14 days of charts.
Inputs
tokenstringrequiredThe token: a CoinGecko id (cardano, chainlink, solana), a symbol (BTC) or a contract addresssincestringoptionalOptional ISO-8601 time to start from, e.g. 2026-10-06T00:00:00ZseriesstringoptionalOptional comma list of charts to include: price, candles, open_interest, funding, long_short, exchange_net_flow, reserves, tvlresolution"auto" | "15m" | "1h" | "6h" | "raw"optionalOptional chart bucket: 15m, 1h, 6h, raw (every row). Default auto: 15m up to 2 days, 1h up to 30 days, 6h beyond
get_market_overview #
The whole crypto market at a glance: total market cap and volume, BTC and ETH dominance, sectors, how many tokens are up or down, Fear & Greed, stablecoins moving to exchanges, network fees, exchange outages, rankings (top gainers and losers, volume spikes, whale activity, exchange inflows and outflows) and the latest market-wide events. Pass `sections` to get only some parts.
Inputs
sectionsstringoptionalOptional comma list: overview, sectors, breadth, sentiment, flows, chains, venues, rankings, events, pulse. Default: all
lookup_address #
Who is behind a blockchain address? Returns its label (an exchange such as Binance, a contract, a burn address, or unlabelled), a screening result (OFAC sanctions, scam/phishing flags), what kind of address it is (exchange, whale, new wallet…), its balances, how many transactions it has made and its recent large transfers. Read live from the chain.
Inputs
chain"eth" | "bsc" | "btc" | "sol" | "ada"requiredThe chain: eth (Ethereum), bsc (BNB Chain), btc (Bitcoin), sol (Solana) or ada (Cardano)addressstringrequiredThe address on that chain
get_service_status #
Is CoinGraph working right now? Shows whether data collection is healthy, how fresh each data source is, what is covered (tokens, exchanges, chains), the current prices and the payment details.
No inputs.
Decide #
Create an object with an id that goes on the public record.
check_token #
The check to run before acting on a token. Returns a verdict — proceed, caution or avoid — rated across momentum, liquidity, leverage, onchain flows, supply, context and contract, with the reasons and their sources. Add `size_usd` to see how your order compares with available liquidity, and `policy` to test your own rules. Each check gets an id you can prove later with get_proof.
Inputs
tokenstringrequiredThe token: a CoinGecko id (cardano, chainlink, solana), a symbol (BTC) or a contract addresssize_usdnumberoptionalOptional: your intended order size in US dollarspolicyobjectoptionalOptional: your rules; each one is reported as pass, fail or unknownpolicy.min_depth_usdnumberoptionalMinimum liquidity within 2% of the pricepolicy.max_top10_holder_pctnumberoptionalMaximum share of supply held by the top 10 holderspolicy.max_funding_pctnumberoptionalMaximum futures funding rate per 8 hours, in percentpolicy.max_exchange_inflow_usdnumberoptionalMaximum net USD moved onto exchanges in 24 hourspolicy.max_unlock_pctnumberoptionalMaximum token unlock (currently reported as unknown)policy.allow_mint_authoritybooleanoptionalWhether a contract that can still mint is acceptable (currently reported as unknown)
get_token_brief #
Why did this token move? Returns CoinGraph's brief: a headline, what happened, the likely causes with confidence, the onchain evidence (whale moves, exchange flows), market context and what to watch next. Every statement cites the evidence behind it. Returns the latest brief; set `fresh` to true to run a new investigation now (takes about a minute).
Inputs
tokenstringrequiredThe token: a CoinGecko id (cardano, chainlink, solana), a symbol (BTC) or a contract addressfreshbooleanoptionalOptional: true to run a new investigation instead of returning the latest briefhoursnumber (1–24)optionalOptional, with fresh: how many hours back to investigate (default 2)
ask_about_token #
Ask CoinGraph anything about a token, or test whether a statement is true. A `question` gets a plain answer with key points and their evidence. A `claim` gets a verdict — supported, contradicted or unknown — with the reasoning. Provide exactly one of the two. Takes 20–40 seconds.
Inputs
tokenstringrequiredThe token: a CoinGecko id (cardano, chainlink, solana), a symbol (BTC) or a contract addressquestionstringoptionalA question, e.g. "Is leverage crowded right now?"claimstringoptionalA statement to test, e.g. "Whales are moving this token onto exchanges"
Watch #
Set up webhooks.
watch_tokens #
Watch up to 50 tokens and get told when something important happens. CoinGraph sends a signed message to your webhook URL when a signal fires (price, volume, whale transfer, liquidations, exchange flows, news…) or a new brief is written. Returns a watch id and a secret that verifies each message (shown once — keep it).
Inputs
tokensstring[]requiredToken ids to watchwebhook_urlstringrequiredPublic https URL that receives the messagesmin_severityinteger (1–3)optionalOptional: only send signals at or above this severity, 1 (low) to 3 (high). Default 2kindsstring[]optionalOptional: only these signal kinds, e.g. whale_transfer, exchange_inflow, price_move
Trust #
The record and the proofs.
get_track_record #
CoinGraph's public scorecard. Every check, signal and brief it issued, what it said, what the price did 1 hour, 24 hours and 7 days later, and whether the call was right — plus the overall hit rate by kind and severity. Pass `token` for one token only.
Inputs
tokenstringoptionalOptional: limit to one tokensincestringoptionalOptional ISO-8601 time; default the last 7 dayskind"evaluation" | "signal" | "brief"optionalOptional: only checks (evaluation), signals or briefs
get_proof #
Proof of exactly what CoinGraph told you. Give the id of a check (eval_…), an answer (ans_…), an agent run (run_…) or a brief (a number) and get the original object, its SHA-256 fingerprint, the Chainlink attestation status and the list of data-source calls behind it.
Inputs
idstringrequiredThe id from a previous answer: eval_…, ans_…, run_… or a brief number
Agents #
One tool per agent. Each returns a verdict, a summary, a structured result, sourced reasons and a run_… id. See Agents for how each one decides.
run_trade_gatekeeper #
The check every trade passes before it is placed. Give it a token, an order size and optionally your rules. It runs the CoinGraph check, measures the real on-chain price impact of your size (DEX aggregator quote) against order-book depth and daily volume, reads leverage, onchain flows and contract risk, and returns ALLOW, REDUCE (with the largest safe size) or BLOCK, with every reason sourced. Returns one of: ALLOW / REDUCE / BLOCK, with a plain summary, structured result, sourced reasons and a proof id.
Inputs
tokenstringrequiredToken: CoinGecko id (chainlink), symbol (LINK) or contract addresssize_usdnumber (…–10000000000)optionaldefault 10000Order size in USDside"buy" | "sell"optionaldefault "buy"max_impact_pctnumber (…–50)optionalLargest acceptable price impact; default 1% for top-20 tokens, 2% otherwisepolicyobjectoptionalpolicy.min_depth_usdnumberoptionalpolicy.max_top10_holder_pctnumberoptionalpolicy.max_funding_pctnumberoptionalpolicy.max_exchange_inflow_usdnumberoptionalpolicy.allow_mint_authoritybooleanoptional
run_wallet_guard #
Checks a swap or a send before you sign it. Before a swap, it checks the token: contract risks (honeypot, taxes, mint/freeze/blacklist powers), the real price impact of the amount, holder concentration and market conditions. Before a send, it checks the recipient live on the chain: OFAC sanctions, scam and phishing flags, burn addresses, brand-new wallets and lookalikes of known addresses (address poisoning). Returns SAFE, WARN or STOP with one plain sentence for the user. Returns one of: SAFE / WARN / STOP, with a plain summary, structured result, sourced reasons and a proof id.
Inputs
tokenstringoptionalThe token being swapped into or sentamount_usdnumber (…–10000000000)optionalAmount in USDto_addressstringoptionalRecipient address (for a send)chain"eth" | "bsc" | "btc" | "sol" | "ada"optionalChain of the recipient address
run_due_diligence_analyst #
A full due-diligence memo on any token in one run. Structured like exchange listing reviews (Coinbase, Kraken) and lending-risk onboarding (Aave, Gauntlet, LlamaRisk): liquidity and markets, supply and holder concentration, contract and admin powers, onchain activity, derivatives, development and community, and CoinGraph's own track record on the token. Each section gets a grade with its evidence, plus red flags, strengths and an overall grade. Returns one of: A / B / C / D / F, with a plain summary, structured result, sourced reasons and a proof id.
Inputs
tokenstringrequiredToken: CoinGecko id (chainlink), symbol (LINK) or contract address
run_opportunity_scout #
Finds what's moving, keeps only what's safe to act on. Scans the 100 tracked tokens for momentum, volume spikes, coins leaving exchanges and fresh signals, runs the full CoinGraph check on each candidate and drops anything rated avoid. Returns a ranked shortlist; each setup has why it is interesting, what could go wrong, an invalidation price and a time horizon. Every setup is recorded and graded later. Returns one of: SETUPS_FOUND / NOTHING_CLEAN, with a plain summary, structured result, sourced reasons and a proof id.
Inputs
limitinteger (1–10)optionaldefault 5
run_leverage_radar #
Spots crowded futures trades before they unwind. Scores every token with a futures market from 0 to 100 for crowding, combining funding against its own 14-day history, open-interest growth (especially while price is flat), top traders' long/short versus their 7-day average, open interest as a share of market cap, and recent liquidations. Returns which side is crowded and how fragile the market is. Returns one of: CROWDED / ELEVATED / BALANCED, with a plain summary, structured result, sourced reasons and a proof id.
Inputs
tokensstring[]optionalTokens to score; default every token with a futures markettopinteger (1–50)optionaldefault 10
run_whale_watch #
Shows what the big wallets are doing with a token. Reads onchain flows through NOWNodes: large transfers tagged with exchange names, net flows onto or off exchanges compared with the token's own 7-day pattern, exchange reserve trends and, live from the chain, who the biggest unlabelled wallets are. Returns ACCUMULATING, DISTRIBUTING or NEUTRAL with the moves behind it. Returns one of: ACCUMULATING / DISTRIBUTING / NEUTRAL / NO_DATA, with a plain summary, structured result, sourced reasons and a proof id.
Inputs
tokenstringrequiredToken: CoinGecko id (chainlink), symbol (LINK) or contract address
run_portfolio_checkup #
A health check for everything in a wallet. Reads a wallet's holdings live from the chain, runs the CoinGraph check on each tracked token, and measures concentration, how many days each position would take to exit at normal volume, and contract risks. Returns a health grade from A to F with fixes ranked by impact. Returns one of: A / B / C / D / F, with a plain summary, structured result, sourced reasons and a proof id.
Inputs
chain"eth" | "bsc" | "btc" | "sol" | "ada"requiredChain: eth (Ethereum), bsc (BNB Chain), btc (Bitcoin), sol (Solana), ada (Cardano)addressstringrequired
run_treasury_steward #
Enforces the treasury's rules, with proof. Give it the treasury's assets and its investment policy (minimum liquidity, maximum holder concentration, maximum funding, maximum exchange inflow, mint authority, maximum exit slippage, maximum share of market cap). It tests every asset against every rule — exit slippage with a live DEX quote for the actual position size — and returns pass/fail per rule per asset, each backed by a proof id, ready to attach to a governance vote. Returns one of: COMPLIANT / BREACH / INCOMPLETE, with a plain summary, structured result, sourced reasons and a proof id.
Inputs
assetsobject[]requiredpolicyobjectrequiredpolicy.min_depth_usdnumberoptionalMinimum liquidity within 2% of pricepolicy.max_top10_holder_pctnumberoptionalpolicy.max_funding_pctnumberoptionalpolicy.max_exchange_inflow_usdnumberoptionalpolicy.allow_mint_authoritybooleanoptionalpolicy.max_exit_slippage_pctnumberoptionalLargest acceptable price impact to sell the whole positionpolicy.max_position_pct_of_market_capnumberoptional
run_alert_watchtower #
Watches your tokens and explains every alert. Give it a list of tokens and optionally a webhook URL. It returns what is happening right now on each token (recent signals with the brief that explains them) and, with a webhook, keeps watching: every new signal or brief is pushed to you as a signed message. Returns one of: ACTIVE / QUIET, with a plain summary, structured result, sourced reasons and a proof id.
Inputs
tokensstring[]requiredwebhook_urlstringoptionalOptional public https URL for continuous alertsmin_severityinteger (1–3)optionaldefault 2hoursinteger (1–48)optionaldefault 24
run_daily_market_brief #
The whole market in one readable page. Opens with CoinGraph's own graded calls from the last 24 hours, then the market regime (risk-on or risk-off, breadth, leverage, Fear & Greed), what changed ranked by importance, stablecoin and exchange flows, the most crowded futures markets, top movers and headlines — and, if you pass your holdings, a line on each. Returned as Markdown and JSON. Returns one of: RISK_ON / RISK_OFF / NEUTRAL, with a plain summary, structured result, sourced reasons and a proof id.
Inputs
holdingsstring[]optionalOptional tokens you hold, for a personal section