io.github.bitcompare/mcp-server

Official18 tools

Crypto yield data for AI agents: lending, savings, staking, borrowing & stablecoin rates. 18 tools.

Access crypto yield rates for lending, staking, borrowing and savings products.

Captured live from the server via tools/list.

get_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.

Parameters (4)

symbolstring
Filter by coin symbol (e.g. "btc")
categorystring
Filter by product category (e.g. "savings", "lending")
providerstring
Filter by provider slug
limitinteger
Max results, default 100

get_rate_by_symbol

Fetch all provider rates for a specific coin symbol. Optionally filter by category.

Parameters (2)

symbolstringrequired
Coin symbol, e.g. "btc" or "eth"
categorystring
Filter to a single product category (e.g. "savings", "lending", "staking")

get_rate_history

Historical rate timeseries for a symbol. Pro plans get up to 5 years; lower plans are clamped server-side. (Current plan: up to 1825 days of history.)

Parameters (3)

symbolstringrequired
Coin symbol
providerstring
Provider slug to scope to
daysinteger
Days of history. Clamped to the plan limit (7 Free, 1825 Pro).

list_providers

All rate providers, optionally filtered by product category.

Parameters (2)

categorystring
Filter to providers that offer this category (e.g. "savings", "lending")
limitinteger
Max results, default 100

get_coin

Full metadata for a coin: description, links, categories, market data, developer stats.

Parameters (1)

coinIdstringrequired
Canonical coin id or slug (e.g. "bitcoin")

list_coins

Paginated list of coins with optional name/symbol search.

Parameters (3)

pageinteger
Page, default 1
limitinteger
Page size, default 20
searchstring
Search by name or symbol

top_coins

Top N coins ordered by market capitalisation.

Parameters (1)

limitinteger
Number of coins, default 100

similar_coins

Coins related to the given coin by category/sector similarity.

Parameters (2)

coinIdstringrequired
Canonical coin id to find related coins for (e.g. "bitcoin")
limitinteger
Max related coins to return, default 10

coin_markets

Exchanges and trading pairs for a coin, with prices and volumes.

Parameters (2)

coinIdstringrequired
Canonical coin id whose markets to fetch (e.g. "ethereum")
limitinteger
Max exchange/pair rows to return, default 50

coin_history

Historical price timeseries for a coin symbol. (Current plan: up to 1825 days of history.)

Parameters (2)

symbolstringrequired
Coin symbol (e.g. "btc")
daysinteger
Days of history

get_price

Current aggregated price for one or more symbols, computed from multiple exchange feeds.

Parameters (2)

symbolsanyrequired
Single symbol or array of symbols (e.g. "btc" or ["btc","eth"])
vsstring
Quote currency, default "usd"

market_summary

One-call summary of total market cap, 24h volume, BTC/ETH dominance, and recent trend.

No parameters.

fear_greed_index

Current Fear & Greed index value and historical trend.

No parameters.

top_movers

Biggest 24h gainers and losers within a rank segment.

Parameters (2)

segmentstring
Rank segment, default "top100"
limitinteger
Number of gainers and losers to return on each side, default 10

stablecoin_index

Ranked stablecoin leaderboard with stability scores, peg deviation, and market cap.

Parameters (1)

limitinteger
Default 50

stablecoin_peg_stability

Peg deviation history and stability stats for a stablecoin.

Parameters (2)

symbolstringrequired
Stablecoin symbol (e.g. "usdt", "usdc")
windowstring
Stability window, default "30d"

resolve_symbol

Map an exchange-specific or ambiguous symbol to bitcompare's canonical coin id. Useful when an exchange uses a non-standard ticker.

Parameters (2)

symbolstringrequired
Exchange-specific or ambiguous symbol
contextstring
Source exchange or quote currency to disambiguate (e.g. "kraken", "binance")

resolve_symbols_batch

Resolve up to 100 symbols in a single request. Requires a plan with bulk endpoints enabled.

Parameters (2)

symbolsarrayrequired
Up to 100 symbols to resolve in a single request
contextstring
Source exchange or quote currency applied to every input symbol

Install

Configuration

Environment variables

BITCOMPARE_API_KEYrequiredsecret

Bearer API key from https://pro.bitcompare.net/dashboard/keys. Format: ck_live_*. Requires a Pro or Enterprise plan for MCP access.

claude_desktop_config.json

{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@bitcompare/mcp-server@1.1.0"
      ],
      "env": {
        "BITCOMPARE_API_KEY": "<YOUR_BITCOMPARE_API_KEY>"
      }
    }
  }
}