NewBitcompare Yield API and MCP now give developers and AI agents access to live crypto yield data.
Bitcompare MCP·21 tools

The crypto yield MCP server for AI agents.

Connect Claude, ChatGPT-compatible MCP hosts, and agent workflows to Bitcompare's live crypto yield intelligence. Query lending rates, staking rewards, borrowing costs, stablecoin yields, provider metadata, market context, and symbol resolution across CeFi and DeFi through one read-only MCP server.

Add to ClaudeGet an API keyView MCP docsView tool catalog

Free keys: get_rates, get_rate_by_symbol and list_providers. Other tools: Pro ($499/mo) or Enterprise.

Three steps, under two minutes

  1. 1

    Get your Pro API key

    Sign up on pro.bitcompare.net, subscribe to Pro, and generate a ck_live_* key from the dashboard.

  2. 2

    Copy the config

    Paste the JSON block below into your Claude Desktop, Claude Code, or Claude.ai client. Restart the client.

  3. 3

    Ask Claude

    "What’s the best yield on BTC right now?" Claude picks up the tool, hits our API, and answers from live data.

Works across the MCP ecosystem

Bitcompare ships a standard read-only MCP server, so it works with any MCP-compatible client — Claude, ChatGPT, VS Code, Cursor, and the rest of the ecosystem. Claude is the fastest way in, but the same server runs anywhere agents run.

Claude DesktopClaude CodeClaude.aiChatGPT (MCP-compatible)VS CodeCursorAny MCP clientOther MCP-aware hostsInternal research agentsWallet, fintech & publisher workflows

What agents can ask

Natural-language questions Claude answers in one call — no scraping, no stale snapshots. Just live rates, yields, and stability data.

What a first call looks like

Sample conversation after the MCP server is connected. Tool call and response shapes match the live API.

  1. You

    "What's the best lending rate on BTC right now, and which provider?"

  3. Claude → Bitcompare MCP

    {
  "tool": "get_rates",
  "input": { "symbol": "btc", "category": "lending" }
}

    Bitcompare → Claude

    {
  "data": {
    "symbol": "BTC",
    "rates": [
      {
        "provider": "nexo",
        "symbol": "BTC",
        "category": "lending",
        "rate": 6,
        "metadata": {
          "source": "nexo_earn_api",
          "duration": 180,
          "baseRate": 2.5,
          "flexRate": 2.5,
          "baseSymbol": "BTC",
          "cryptoName": "Bitcoin",
          "hasFloorApy": false,
          "durationType": "fixed",
          "rewardsClaim": "automatic",
          "warmUpPeriod": {
            "type": "range",
            "numbers": [
              1,
              1
            ],
            "periods": [
              "day",
              "day"
            ]
          },
          "rewardsPayout": "automatic",
          "rewardFrequency": {
            "text": "daily",
            "type": "text"
          },
          "minPurchaseAmount": "0.001",
          "undelegationPeriod": {
            "text": "immediate",
            "type": "text"
          },
          "flexProviderSymbol": "BTC-FLEX"
        },
        "lastUpdated": "2026-11-08T10:00:59.592Z",
        "coinId": "bitcoin",
        "providerSymbol": "BTC-180D",
        "unitType": "percentage",
        "unitSymbol": "%",
        "ageSeconds": 145,
        "stale": false
      },
      {
        "provider": "youhodler",
        "symbol": "BTC",
        "category": "lending",
        "rate": 7,
        "metadata": null,
        "lastUpdated": "2026-11-08T10:00:45.794Z",
        "coinId": "bitcoin",
        "providerSymbol": "BTC",
        "unitType": "percentage",
        "unitSymbol": "%",
        "ageSeconds": 159,
        "stale": false
      },
      {
        "provider": "spark",
        "symbol": "BTC",
        "category": "lending",
        "rate": 0.00000792,
        "metadata": {
          "mode": "aave_liquidity_rate",
          "method": "getReserveData",
          "source": "onchain_rate",
          "chainId": 1,
          "contract": "0xC13e21B648A5Ee794902342038FF3aDAB66BE987"
        },
        "lastUpdated": "2026-11-08T10:00:44.700Z",
        "coinId": "bitcoin",
        "providerSymbol": "BTC",
        "unitType": "percentage",
        "unitSymbol": "%",
        "ageSeconds": 160,
        "stale": false
      }
    ],
    "count": 11
  }
}

  5. Claude

    "Youhodler is paying 7.0% APY on BTC lending right now — the best rate I'm seeing across all tracked providers. Want me to compare it against the top 5?"

Illustrative example. Actual rates and providers fluctuate; see live data via the API or on bitcompare.net.

21 tools, grouped by job

All tools are read-only, structured JSON, and streamed through the same plan limits you already use for REST.

Find current yield

Rates

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.

GET /api/v1/rates
Rates

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

GET /api/v1/rates/eth

Track changes

Rates

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.

GET /api/v1/rates/btc/history
Earn

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.

GET /api/v1/rates/changes

Understand providers

Rates

list_providers

List rate providers

All rate providers, optionally filtered by product category.

GET /api/v1/providers
Earn

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?"

GET /api/v1/earn/products

Understand assets

Coins

get_coin

Get coin metadata

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

GET /api/v1/coins/bitcoin
Coins

list_coins

List coins

Paginated list of coins with optional name/symbol search.

GET /api/v1/coins
Coins

top_coins

Top coins by market cap

Top N coins ordered by market capitalisation.

GET /api/v1/coins/top
Coins

similar_coins

Similar coins

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

GET /api/v1/coins/bitcoin/similar
Coins

coin_history

Historical coin price chart

Historical price timeseries for a coin.

GET /api/v1/coins/bitcoin/history

Add market context

Prices

get_price

Aggregated exchange price

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

GET /api/v1/prices/summary
Prices

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.

GET /api/v1/prices/btc
Market

market_summary

Global market summary

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

GET /api/v1/global-stats/summary
Market

fear_greed_index

Fear & Greed index

Current Fear & Greed index value and historical trend.

GET /api/v1/global-stats/fear-greed
Market

top_movers

Top gainers/losers

Biggest 24h gainers and losers within a rank segment.

GET /api/v1/global-stats/movers

Check stablecoins

Stablecoins

stablecoin_index

Stablecoin stability leaderboard

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

GET /api/v1/stablecoins/index
Stablecoins

stablecoin_peg_stability

Stablecoin peg stability

Peg deviation history and stability stats for a stablecoin.

GET /api/v1/stablecoins/peg-stability
Benchmarks

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.

GET /api/v1/benchmarks/stablecoin

Resolve symbols

Symbols

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.

GET /api/v1/symbols/resolve
Symbols

resolve_symbols_batch

Batch resolve symbols

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

POST /api/v1/symbols/resolve/batch

Setup

Drop the config into your Claude client. Replace ck_live_... with your API key.

{
  "mcpServers": {
    "bitcompare": {
      "command": "npx",
      "args": ["-y", "@bitcompare/mcp-server"],
      "env": {
        "BITCOMPARE_API_KEY": "ck_live_..."
      }
    }
  }
}

Pricing & access

No surprises after you click “Get an API key.” Here’s exactly what you get and how billing works.

What you need

  • Free API keys can call get_rates, get_rate_by_symbol and list_providers (30 requests/minute, 10,000/month).
  • The other tools, including get_rate_history, require Pro ($499/mo) or Enterprise.
  • Public docs and the OpenAPI spec stay open: no login required to read them.

One key, two surfaces: the same ck_live_ API key authenticates both the REST API and the MCP server.

Get your key

  1. 1Sign up for a Bitcompare account.
  2. 2Choose Free for the three current-rate and provider tools, or Pro for all MCP tools.
  3. 3Generate a ck_live_ key in your dashboard.

“Get an API key” takes you to signup at the secure auth/Pro portal. Already have an account? Head straight to your dashboard keys.

Get an API key

Trust & safety

Agents answer real people from this data. Here is how it behaves and what it does — and does not — claim.

Read-onlyEvery tool is read-only. The MCP server returns data — it never moves funds, places orders, or mutates anything on your behalf.
Rates change and varyRates move constantly and differ by region, account tier, balance, lockup period, and individual provider terms. Treat any single figure as a snapshot, not a guarantee.
Freshness is surfacedTimestamps and freshness indicators are included in responses where available, so agents can tell users how recent a figure is.
Sponsored vs organicSponsored placements are clearly separated from organic rate data. Agents can distinguish paid positioning from independently sourced rates.
Not financial adviceOutputs are informational data, not financial advice. Users should verify with the provider before acting.
MethodologySponsored-placement policyRisk warning

Next steps

Developer docsSetup walkthrough, auth, rate limits, tool reference.Connect from your dashboardAlready have a Pro key? Wire up MCP in two clicks.Anthropic MCP registryThe canonical list of community MCP servers.

Where this fits in the Bitcompare stack

The MCP server is the setup surface. These are the sibling pages for buyers, the packaged product, and the REST alternative.

Crypto yield data for AI agentsEvaluating whether your agents should use Bitcompare data? The buyer-facing overview of coverage, licensing, and use cases.Yield CopilotThe packaged product built on these MCP tools — ask questions about crypto yield without wiring up a client yourself.Developer hubPrefer plain REST? The docs hub for the OpenAPI surface, auth, and SDKs behind every MCP tool.Crypto yield APIThe underlying crypto yield API product these tools call — pricing, plans, and endpoint reference.

Machine-readable & agent discovery

Stable, crawlable surfaces for agents, registries, and code generators.

openapi.jsonFull REST surface behind the MCP tools — code generation and integration testing.tools.jsonJSON-Schema-typed tool list for registries.npm package@bitcompare/mcp-server — install or pin the server.llms.txtPlain-text agent manifest..well-known/mcp.jsonCanonical MCP descriptor + tools preview..well-known/ai-plugin.jsonPlugin manifest for agent toolchains..well-known/agent.jsonAgent identity manifest.

Available on

npm

Coming soon to Smithery, mcp.so, Official MCP Registry, Glama, PulseMCP.

Give your agents live crypto yield intelligence.

One read-only MCP server, one API key. Connect Claude or any MCP-aware agent and start querying live yield, rates and market data in minutes.

Add to ClaudeGet an API keyView MCP docs