# Bitcompare MCP

> Crypto rates, prices, coin metadata, market stats, and stablecoin stability data 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. Use this to answer "what is the best yield on BTC right now?" style questions.
  - Endpoint: `GET /api/v1/rates`
  - Example: `{"symbol":"btc","category":"savings","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.
  - Endpoint: `GET /api/v1/rates/eth`
  - Example: `{"symbol":"eth","category":"lending"}`
- **get_rate_history** — Historical rates. Historical rate timeseries for a symbol. Pro plans get up to 5 years; lower plans are clamped server-side.
  - 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":"savings"}`

### 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_markets** — Markets trading a coin. Exchanges and trading pairs for a coin, with prices and volumes.
  - Endpoint: `GET /api/v1/coins/ethereum/markets`
  - Example: `{"coinId":"ethereum","limit":20}`
- **coin_history** — Historical coin price chart. Historical price timeseries for a coin symbol.
  - Endpoint: `GET /api/v1/coins/history/btc`
  - Example: `{"symbol":"btc","days":30}`

### 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`
  - Example: `{"symbols":["btc","eth"],"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/usdc/peg-stability`
  - Example: `{"symbol":"usdc","window":"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"}`

## Machine-readable tool catalog

JSON: https://api.bitcompare.net/mcp/tools.json