MCP Tool Catalog

All 21 tools the Bitcompare MCP server exposes. Each tool maps 1:1 to a REST endpoint and respects the same plan limits, errors, and rate limiting.

This is the human-readable catalog. The machine-readable version with full JSON-Schema typing is at api.bitcompare.net/mcp/tools.json — use that when generating client code or registering with an MCP registry.

Rates

Lending, borrowing, staking, and savings yields across 50+ providers.

ToolDescriptionREST endpoint
get_ratesList current rates across providers, optionally filtered by symbol, category, or provider. Use for "what's the best yield on BTC right now?" style questions.GET /api/v1/rates
get_rate_by_symbolFetch all provider rates for a single coin symbol. Optionally filter by category.GET /api/v1/rates/{symbol}
get_rate_historyHistorical rate timeseries for a symbol. Pro: up to 5 years; lower plans are clamped server-side.GET /api/v1/rates/{symbol}/history
list_providersAll rate providers, optionally filtered by product category.GET /api/v1/providers

Deep docs: Rates.

Coins

Metadata, markets, history, and similarity for 500+ cryptocurrencies.

ToolDescriptionREST endpoint
get_coinFull metadata for a coin: description, links, categories, market data, developer stats.GET /api/v1/coins/{coinId}
list_coinsPaginated list of coins with optional name/symbol search.GET /api/v1/coins
top_coinsTop N coins ordered by market capitalisation.GET /api/v1/coins/top
similar_coinsCoins similar to a given coin (category + market-cap clustering).GET /api/v1/coins/{coinId}/similar
coin_historyHistorical OHLC and market data for a coin.GET /api/v1/coins/{coinId}/history
coin_marketsPer-exchange market data for a coin.GET /api/v1/coins/{coinId}/markets

Deep docs: Coins.

Prices

Aggregated cryptocurrency prices using median calculation with outlier filtering.

ToolDescriptionREST endpoint
get_priceMedian price across multiple providers.GET /api/v1/prices/{symbol}

Deep docs: Prices.

Market

Global market statistics, sentiment, and movement signals.

ToolDescriptionREST endpoint
market_summaryTotal market cap, dominance, 24h volume.GET /api/v1/global
fear_greed_indexCrypto Fear & Greed Index (current + 30d window).GET /api/v1/global/fear-and-greed
top_moversBiggest 24h gainers and losers across the top 200 coins.GET /api/v1/global/movers

Deep docs: Global Stats.

Stablecoins

Stability leaderboard ranked by peg deviation and historical drift.

ToolDescriptionREST endpoint
stablecoin_indexStability leaderboard ranked by peg deviation.GET /api/v1/stablecoins
stablecoin_peg_stabilityHistorical peg deviation for a stablecoin.GET /api/v1/stablecoins/{symbol}/history

Deep docs: Stablecoin Index.

Symbols

Map exchange-specific tickers to canonical coin identifiers.

ToolDescriptionREST endpoint
resolve_symbolResolve exchange-specific tickers (e.g. BTC, XBT, wBTC) to canonical coin IDs.GET /api/v1/symbols/resolve
resolve_symbols_batchResolve many exchange tickers in a single call.POST /api/v1/symbols/resolve/batch

Deep docs: Symbols.

Benchmarks

The Bitcompare Earn Index — the citable market reference for stablecoin yield.

ToolDescriptionREST endpoint
stablecoin_earn_benchmarkBEI-Stable: median USDC/USDT lending APY across servable providers, with CeFi/DeFi splits, a TVL-weighted DeFi variant, deltas, and an immutable daily history. Omit history_days for the headline; set it for the series. Anonymous/free callers are clamped to the most recent 90 days of history (clamped: true); Intelligence-tier keys get full depth.GET /api/v1/benchmarks/stablecoin · GET /api/v1/benchmarks/stablecoin/history
  • Name
    segment
    Type
    string
    Description

    overall, cefi, or defi. Omit for the headline across all three.

  • Name
    history_days
    Type
    integer
    Description

    1–1825. When set, returns the daily series for the last N days instead of the headline.

Example call

{ "segment": "overall", "history_days": 30 }

Deep docs: Stablecoin Earn Benchmark · Methodology.

Earn Intelligence

The observation log and the product/variant terms behind every rate. Both tools call Intelligence-tier REST endpoints: the key on the MCP connection must be on a Pro or Enterprise plan, or the tool returns 403 PLAN_UPGRADE_REQUIRED with an upgradeUrl of https://pro.bitcompare.net/pricing.

ToolDescriptionREST endpoint
get_rate_changesThe immutable rate-change log: every material yield move with full provenance (previous rate, raw value, multiplier, collection method, confidence, base/bonus split), as time-ascending cursor pages. Unfiltered windows are capped at 31 days; filter by provider or symbol to walk deep history. Use for "what changed since X?" and audit trails.GET /api/v1/rates/changes
list_earn_productsThe canonical earn product graph: products (provider × asset × category) with their term variants — lockups, tiers, minimum deposits, payout schedules, withdrawal notice, TVL, promo flags — each with collection method, confidence band, verification timestamps, and resolved geo eligibility. Use for "what are the actual terms behind this rate?"GET /api/v1/earn/products

get_rate_changes input

  • Name
    since
    Type
    string
    Description

    Required. ISO date or datetime lower bound, e.g. "2026-08-01". Clamped to the plan's lookback (365 days on Pro, 5 years on Enterprise).

  • Name
    until
    Type
    string
    Description

    ISO upper bound. Defaults to now.

  • Name
    provider
    Type
    string
    Description

    Filter to one provider slug. Lifts the 31-day window cap.

  • Name
    symbol
    Type
    string
    Description

    Filter to one symbol, e.g. "USDC". Lifts the 31-day window cap.

  • Name
    category
    Type
    string
    Description

    lending, borrowing, or staking.

  • Name
    cursor
    Type
    string
    Description

    Opaque cursor from a previous page's pagination.nextCursor.

  • Name
    limit
    Type
    integer
    Description

    1–500. Defaults to 100.

Example call

{ "since": "2026-08-01", "symbol": "USDC", "category": "lending" }

list_earn_products input

  • Name
    provider
    Type
    string
    Description

    Filter to one provider slug, e.g. "nexo".

  • Name
    symbol
    Type
    string
    Description

    Filter to one symbol, e.g. "BTC".

  • Name
    category
    Type
    string
    Description

    lending, borrowing, or staking.

  • Name
    min_confidence
    Type
    integer
    Description

    0–100. Only products with at least one variant at or above this confidence.

  • Name
    limit
    Type
    integer
    Description

    1–200. Defaults to 50.

  • Name
    offset
    Type
    integer
    Description

    Zero-based paging offset.

Example call

{ "provider": "nexo", "symbol": "BTC", "category": "lending" }

Deep docs: Rate Changes · Earn Products · Coverage.

See also

Was this page helpful?