Mcp Server

bitcompare/mcp-server

Plugs live crypto data from Bitcompare into Claude via 18 read-only tools. You get current and historical interest rates across lending and staking providers, coin metadata and price charts, aggregated exchange prices, global market stats including Fear and Greed index, stablecoin peg stability scores, and symbol resolution for handling exchange-specific tickers. Runs as a local stdio server via npx or connects over HTTPS to api.bitcompare.net. Requires a Bitcompare Pro API key at $499/month with a free trial available. Useful when you need Claude to answer yield comparison questions, track peg deviations, or pull structured market data without leaving the conversation.

tools: 21
auth: Secret needed
transport: STDIO, HTTP
env var: 1
last updated: Nov 13, 2026

View on GitHub

Install

From registry metadata

$ npx add-mcp https://api.bitcompare.net/mcp --name bitcompare --header 'Authorization: Bearer ${API_TOKEN}'

Run in your terminal. add-mcp asks which agents to add it to, then asks for each value it needs. Add -g to install it for every project.

Review the command, arguments and environment values before installing. MCP servers run with your local permissions.

Other ways

Claude Code

$ claude mcp add --transport http bitcompare https://api.bitcompare.net/mcp --header 'Authorization: YOUR_AUTHORIZATION'

Run in your terminal. Add --scope user to make it available in every project.

Tools

Verified live · 21 tools

Verified live against the running server on Nov 6, 2026.

get_ratesList 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"), n...4 params

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"), n...

Parameters* required

categorystring

Filter by product category. IMPORTANT for yield questions: without this filter, most returned rows are category="price" (spot prices), not yields. Pass category="lending", "borrowing", or "staking"...one of lending · borrowing · staking · price

limitinteger

Max results, default 100

providerstring

Filter by provider slug, case-insensitive

symbolstring

Filter by coin symbol, case-insensitive (e.g. "btc" or "BTC")

get_rate_by_symbolFetch 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").2 params

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").

Parameters* required

categorystring

Filter to a single product category. Without it, results mix spot prices (category="price") in with yields — pass "lending"/"borrowing"/"staking" for yield-only results.one of lending · borrowing · staking · price

symbol*string

Coin symbol, case-insensitive (e.g. "btc" or "eth")

get_rate_historyHistorical 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. (Current plan: up to 1825 days of history.)3 params

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. (Current plan: up to 1825 days of history.)

Parameters* required

daysinteger

Days of history. Clamped server-side to your plan (Free 7, Starter 30, Growth 90, Pro 365, Enterprise 1825) and bounded by available data. Points within ~30 days are per-tick; older points are daily.

providerstring

Provider slug to scope to, case-insensitive

symbol*string

Coin symbol, case-insensitive

list_providersAll rate providers, optionally filtered by product category.2 params

All rate providers, optionally filtered by product category.

Parameters* required

categorystring

Filter to providers that offer this categoryone of lending · borrowing · staking · price

limitinteger

Max results, default 100

get_coinFull metadata for a coin: description, links, categories, market data, developer stats.1 params

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

Parameters* required

coinId*string

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

list_coinsPaginated list of coins with optional name/symbol search.3 params

Paginated list of coins with optional name/symbol search.

Parameters* required

limitinteger

Page size, default 20

pageinteger

Page, default 1

searchstring

Search by name or symbol

top_coinsTop N coins ordered by market capitalisation.1 params

Top N coins ordered by market capitalisation.

Parameters* required

limitinteger

Number of coins, default 100

similar_coinsCoins related to the given coin by category/sector similarity.2 params

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

Parameters* required

coinId*string

Canonical coin id to find related coins for (e.g. "bitcoin")

limitinteger

Max related coins to return, default 10

coin_historyHistorical price timeseries for a coin. (Current plan: up to 1825 days of history.)2 params

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

Parameters* required

coinId*string

Canonical coin id (e.g. "bitcoin")

daysinteger

Days of history

get_priceCurrent aggregated price for one or more symbols, computed from multiple exchange feeds.2 params

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

Parameters* required

symbols*value

Single symbol or array of symbols (e.g. "btc" or ["btc","eth"])

vsstring

Quote currency, default "usd"

get_price_by_symbolAggregated exchange price for one symbol, plus the raw per-provider prices that fed the aggregate. Use get_price for multiple symbols in one call.3 params

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.

Parameters* required

regionstring

Optional region filter for provider selection

symbol*string

Single coin symbol, e.g. "btc"

vsstring

Quote currency, default "usd"

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

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

No parameters. Call it with no arguments.

fear_greed_indexCurrent Fear & Greed index value and historical trend.

Current Fear & Greed index value and historical trend.

No parameters. Call it with no arguments.

top_moversBiggest 24h gainers and losers within a rank segment.2 params

Biggest 24h gainers and losers within a rank segment.

Parameters* required

limitinteger

Number of gainers and losers to return on each side, default 10

segmentstring

Rank segment, default "top100"one of top10 · top100 · top1000

stablecoin_indexRanked stablecoin leaderboard with stability scores, peg deviation, and market cap.1 params

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

Parameters* required

limitinteger

Default 50

stablecoin_peg_stabilityPeg deviation history and stability stats for a stablecoin.2 params

Peg deviation history and stability stats for a stablecoin.

Parameters* required

periodstring

Stability window, default "30d"one of 7d · 30d · 90d

symbol*string

Stablecoin symbol (e.g. "usdt", "usdc")

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

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

Parameters* required

contextstring

Source exchange or quote currency to disambiguate (e.g. "kraken", "binance")

symbol*string

Exchange-specific or ambiguous symbol

resolve_symbols_batchResolve up to 100 symbols in a single request. Requires a plan with bulk endpoints enabled.2 params

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

Parameters* required

contextstring

Source exchange or quote currency applied to every input symbol

symbols*array

Up to 100 symbols to resolve in a single request

stablecoin_earn_benchmarkThe 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 citabl...2 params

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

Parameters* required

history_daysinteger

Request the daily series for the last N days instead of the headline. Anonymous/free access is clamped to the most recent 90 days.

segmentstring

Restrict to one segment. Omit for the headline across overall + CeFi + DeFi.one of overall · cefi · defi

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). Time-ascending pages via cursor. Unfiltered windows are capped at 31 days — filter by provider or symbol to wa...7 params

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

Parameters* required

categorystring

one of lending · borrowing · staking

cursorstring

Opaque cursor from a previous page

limitinteger

Page size, default 100

providerstring

Filter to one provider (enables deep ranges)

since*string

ISO date/datetime lower bound (required), e.g. "2026-08-01"

symbolstring

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

untilstring

ISO upper bound, default now

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 carrying collection method, confidence (0-100 with bands), verification timestamps...6 params

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

Parameters* required

categorystring

one of lending · borrowing · staking

limitinteger

Page size, default 50

min_confidenceinteger

Only products with at least one variant at/above this confidence

offsetinteger

providerstring

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

symbolstring

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

Configuration

BITCOMPARE_API_KEY*secret

Bearer API key from https://auth.bitcompare.net/pro/signup. Format: ck_live_*. Free keys can use get_rates, get_rate_by_symbol and list_providers; the other tools need a paid plan (Starter or above).

Readme

@bitcompare/mcp-server

The official crypto yield data MCP server: native Claude access to live and historical crypto lending, savings, staking, borrowing, stablecoin, price, coin metadata, and market data. Built on Model Context Protocol — works with Claude Desktop, Claude Code, Claude.ai, and any MCP-compatible agent.

One npm install, twenty-one tools, one API key.

npx -y @bitcompare/mcp-server

Free API keys can call get_rates, get_rate_by_symbol and list_providers (30 requests/minute, 10,000/month). Every other tool, including get_rate_history, needs a paid plan (Starter at $49/mo or above). Sign up at https://auth.bitcompare.net/pro/signup. Requires npm 1.2.0 or later; 1.1.0 has 18 tools and only works with Pro or Enterprise.

What you get

21 read-only tools. Calls use the same API key and request quotas as REST:

View the full README on GitHub

Details

Repository: github.com/bitcompare/mcp-server
Website: bitcompare.net/mcp
Categories: Data & Analytics, Finance & Commerce
Package: @bitcompare/mcp-server
Transport: STDIO, HTTP
Auth: Required
Registry: MCP registry, active
Tools verified: Nov 6, 2026

Related Data & Analytics MCP servers

View all

Mcpblockchainacademics/bca-mcpCited crypto news, prices, onchain data, sentiment and indicators: 105 tools. Not financial advice.0stars

MeteoSwiss MCP Servereins78/meteoswiss-llm-toolsSwiss weather data for AI assistants — forecasts, measurements, stations, pollen.0stars

FlightDBflightdb/flightdb-mcpAircraft registry search, flight history, and analytics powered by ADS-B Exchange data.1stars

Bunprojbeshir/mcp-serversRead Bunpro SRS data: profile, study queue, reviews, JLPT progress, and grammar lookups.0stars

WaniKanijbeshir/mcp-serversRead WaniKani SRS data: profile, reviews, assignments, subjects, and level progressions.0stars

Groupsioke4qqq/groupsio-mcp-serverMCP server for consuming and managing Groups.io data via the Groups.io REST API1stars