mcp-server

@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, eighteen tools, one API key.

npx -y @bitcompare/mcp-server

Requires a Bitcompare Pro or Enterprise plan. Get a ck_live_* key at <https://pro.bitcompare.net/dashboard/keys>.

What you get

18 read-only tools, all gated by the same plan limits as REST:

• Crypto yield data — current & historical lending, borrowing, savings, and staking APYs across CeFi and DeFi providers
• Coins — metadata, markets, history, similar coins, and top-by-market-cap lookups
• Prices — aggregated exchange prices with median + outlier filtering
• Global market stats — total market cap, dominance, Fear & Greed Index, 24h top movers
• Stablecoin data — peg deviation leaderboard, historical drift, and yield comparison
• Symbol resolution — map exchange-specific tickers (BTC, XBT, wBTC) to canonical coin IDs

Full tool catalog: <https://www.bitcompare.net/mcp> · machine-readable: <https://api.bitcompare.net/mcp/tools.json> · agent manifest: <https://api.bitcompare.net/llms.txt>.

Install

You don't need to install it — run via npx:

BITCOMPARE_API_KEY=ck_live_... npx @bitcompare/mcp-server --test

Configure Claude Desktop

Edit claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json):

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

Restart Claude Desktop. Ask "what's the best yield on BTC right now?" — Claude will call get_rates and answer from live data.

Configure Claude Code

In your project's .claude/settings.local.json:

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

Hosted alternative

If you prefer not to install anything, we also run the MCP server at https://api.bitcompare.net/mcp over Streamable HTTP. Point your MCP client at that URL with an Authorization: Bearer ck_live_* header.

Docker

A container is provided for hosted introspection (e.g. Glama). It installs the published npm package and runs the server over stdio:

docker build -t bitcompare-mcp .
docker run -i -e BITCOMPARE_API_KEY=ck_live_... bitcompare-mcp

tools/list introspection works without a key; tool calls require a valid ck_live_ Pro key.

CLI flags

• --test — validate your key and list available tools, then exit
• --version — print version
• --help — print help
• --base-url <url> — override API base URL (for staging/dev)

Source

The server is developed in the Bitcompare services monorepo and published to npm as @bitcompare/mcp-server. This repository mirrors the published package and its container for public discovery and hosted introspection.

Support

• Documentation: <https://www.bitcompare.net/mcp>
• Issues: <https://github.com/bitcompare/mcp-server/issues>
• Email: <support@bitcompare.net>

License

MIT — see LICENSE.