# Bitcompare MCP

> Normalized crypto yield intelligence for AI agents and APIs: current and historical lending, savings, and staking rates across CeFi and DeFi providers, each with a freshness timestamp. Plus supporting market data — aggregated prices, coin metadata, global market stats, and stablecoin peg stability — for Claude and other MCP-compatible agents.

## Connection

- Endpoint: https://api.bitcompare.net/mcp
- Transport: Streamable HTTP (MCP)
- Auth: `Authorization: Bearer ck_live_*` (get a key at https://pro.bitcompare.net)
- Plan required: Pro or Enterprise
- npm alternative: `npx @bitcompare/mcp-server`

## Tools

### Rates (yield/lending/savings)

- **get_rates** — Get current rates. List current rates across providers, optionally filtered by symbol, category, or provider. For "what is the best yield on BTC right now?" style questions, ALWAYS pass category="lending"/"borrowing"/"staking" — an unfiltered call mostly returns spot prices (category="price"), not yields.
  - Endpoint: `GET /api/v1/rates`
  - Example: `{"symbol":"btc","category":"lending","limit":10}`
- **get_rate_by_symbol** — Get rates for a single symbol. Fetch all provider rates for a specific coin symbol. Optionally filter by category — pass category="lending"/"borrowing"/"staking" for yield questions, since unfiltered results mix in spot prices (category="price").
  - Endpoint: `GET /api/v1/rates/eth`
  - Example: `{"symbol":"eth","category":"lending"}`
- **get_rate_history** — Historical rates. Historical rate timeseries for a symbol. Recent history (~30 days) is per-tick; older history is daily granularity. Depth is clamped to your plan (up to 365 days on Pro) and bounded by how far back data has been recorded.
  - Endpoint: `GET /api/v1/rates/btc/history`
  - Example: `{"symbol":"btc","days":30}`
- **list_providers** — List rate providers. All rate providers, optionally filtered by product category.
  - Endpoint: `GET /api/v1/providers`
  - Example: `{"category":"lending"}`

### Coins (metadata & history)

- **get_coin** — Get coin metadata. Full metadata for a coin: description, links, categories, market data, developer stats.
  - Endpoint: `GET /api/v1/coins/bitcoin`
  - Example: `{"coinId":"bitcoin"}`
- **list_coins** — List coins. Paginated list of coins with optional name/symbol search.
  - Endpoint: `GET /api/v1/coins`
  - Example: `{"search":"eth","limit":10}`
- **top_coins** — Top coins by market cap. Top N coins ordered by market capitalisation.
  - Endpoint: `GET /api/v1/coins/top`
  - Example: `{"limit":10}`
- **similar_coins** — Similar coins. Coins related to the given coin by category/sector similarity.
  - Endpoint: `GET /api/v1/coins/bitcoin/similar`
  - Example: `{"coinId":"bitcoin","limit":5}`
- **coin_history** — Historical coin price chart. Historical price timeseries for a coin.
  - Endpoint: `GET /api/v1/coins/bitcoin/history`
  - Example: `{"coinId":"bitcoin","days":7}`

### Aggregated prices

- **get_price** — Aggregated exchange price. Current aggregated price for one or more symbols, computed from multiple exchange feeds.
  - Endpoint: `GET /api/v1/prices/summary`
  - Example: `{"symbols":["btc","eth"],"vs":"usd"}`
- **get_price_by_symbol** — Aggregated price for a single symbol. Aggregated exchange price for one symbol, plus the raw per-provider prices that fed the aggregate. Use get_price for multiple symbols in one call.
  - Endpoint: `GET /api/v1/prices/btc`
  - Example: `{"symbol":"btc","vs":"usd"}`

### Global market stats

- **market_summary** — Global market summary. One-call summary of total market cap, 24h volume, BTC/ETH dominance, and recent trend.
  - Endpoint: `GET /api/v1/global-stats/summary`
  - Example: `{}`
- **fear_greed_index** — Fear & Greed index. Current Fear & Greed index value and historical trend.
  - Endpoint: `GET /api/v1/global-stats/fear-greed`
  - Example: `{}`
- **top_movers** — Top gainers/losers. Biggest 24h gainers and losers within a rank segment.
  - Endpoint: `GET /api/v1/global-stats/movers`
  - Example: `{"segment":"top100","limit":10}`

### Stablecoins

- **stablecoin_index** — Stablecoin stability leaderboard. Ranked stablecoin leaderboard with stability scores, peg deviation, and market cap.
  - Endpoint: `GET /api/v1/stablecoins/index`
  - Example: `{"limit":20}`
- **stablecoin_peg_stability** — Stablecoin peg stability. Peg deviation history and stability stats for a stablecoin.
  - Endpoint: `GET /api/v1/stablecoins/peg-stability`
  - Example: `{"symbol":"usdc","period":"30d"}`

### Symbol resolution

- **resolve_symbol** — Resolve symbol to canonical coin. Map an exchange-specific or ambiguous symbol to bitcompare's canonical coin id. Useful when an exchange uses a non-standard ticker.
  - Endpoint: `GET /api/v1/symbols/resolve`
  - Example: `{"symbol":"xbt","context":"kraken"}`
- **resolve_symbols_batch** — Batch resolve symbols. Resolve up to 100 symbols in a single request. Requires a plan with bulk endpoints enabled.
  - Endpoint: `POST /api/v1/symbols/resolve/batch`
  - Example: `{"symbols":["xbt","weth","wbtc"],"context":"kraken"}`

### Benchmarks (Bitcompare Earn Index)

- **stablecoin_earn_benchmark** — Bitcompare Earn Index (BEI-Stable). The Bitcompare Earn Index for stablecoins: median USDC/USDT lending APY across servable providers, with CeFi/DeFi splits, TVL-weighted variant, deltas, and an immutable daily history. Use for "what does stablecoin yield pay right now / how has it trended?" — this is the citable market reference, not a single provider quote.
  - Endpoint: `GET /api/v1/benchmarks/stablecoin`
  - Example: `{}`

### Earn Intelligence (changes & product terms)

- **get_rate_changes** — Rate change feed (observations). The immutable rate-change log: every material yield move with full provenance (previous rate, raw value, multiplier, collection method, confidence, base/bonus split). Time-ascending pages via cursor. 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.
  - Endpoint: `GET /api/v1/rates/changes`
  - Example: `{"since":"2026-08-01","symbol":"USDC","category":"lending"}`
- **list_earn_products** — Canonical earn products & variants. The canonical earn product graph: products (provider × asset × category) with their term variants — lockups, tiers, minimum deposits, payout schedules, withdrawal notice, TVL, promo flags — each carrying collection method, confidence (0-100 with bands), verification timestamps, and geo eligibility resolved from variant overrides or provider defaults. Use for "what are the actual terms behind this rate?"
  - Endpoint: `GET /api/v1/earn/products`
  - Example: `{"provider":"nexo","symbol":"BTC","category":"lending"}`

## Agent discovery

Machine-readable manifests for agents and registry crawlers. Relative paths resolve against whichever host serves this file (api.bitcompare.net and the bitcompare.net mirror both serve them):

- Tool catalog (JSON): /mcp/tools.json
- MCP server descriptor: /.well-known/mcp.json
- OpenAPI 3.1 spec: /openapi.json
- ChatGPT plugin manifest: https://bitcompare.net/.well-known/ai-plugin.json
- Agent card (A2A): https://bitcompare.net/.well-known/agent.json
- Marketing / human overview: https://bitcompare.net/mcp