# bitcompare/mcp-server [Health: Active] **Category:** ๐Ÿ’ฐ Finance & Fintech **Repository:** https://github.com/bitcompare/mcp-server **GitHub Stars:** 1 **npm Downloads (last month):** 275 **Views:** 1 **Installs:** 0 **Upvotes:** 0 **Directory Page:** https://allmcps.com/mcp/bitcompare-mcp-server ## Description Crypto rates (lending, staking, borrowing), coin metadata, aggregated prices, market stats, stablecoin peg-stability, and symbol resolution. 18 tools. Hosted at api.bitcompare.net/mcp or via npx @bitcompare/mcp-server. ## Tools Capabilities this server exposes over MCP: - **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. - **get_rate_by_symbol** โ€” Fetch all provider rates for a specific coin symbol. Optionally filter by category. - **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 7 days of history.) - **list_providers** โ€” All rate providers, optionally filtered by product category. - **get_coin** โ€” Full metadata for a coin: description, links, categories, market data, developer stats. - **list_coins** โ€” Paginated list of coins with optional name/symbol search. - **top_coins** โ€” Top N coins ordered by market capitalisation. - **similar_coins** โ€” Coins related to the given coin by category/sector similarity. - **coin_markets** โ€” Exchanges and trading pairs for a coin, with prices and volumes. - **coin_history** โ€” Historical price timeseries for a coin symbol. (Current plan: up to 7 days of history.) - **get_price** โ€” Current aggregated price for one or more symbols, computed from multiple exchange feeds. - **market_summary** โ€” One-call summary of total market cap, 24h volume, BTC/ETH dominance, and recent trend. - **fear_greed_index** โ€” Current Fear & Greed index value and historical trend. - **top_movers** โ€” Biggest 24h gainers and losers within a rank segment. - **stablecoin_index** โ€” Ranked stablecoin leaderboard with stability scores, peg deviation, and market cap. - **stablecoin_peg_stability** โ€” Peg deviation history and stability stats for a stablecoin. - **resolve_symbol** โ€” Map an exchange-specific or ambiguous symbol to bitcompare's canonical coin id. Useful when an exchange uses a non-standard ticker. - **resolve_symbols_batch** โ€” Resolve up to 100 symbols in a single request. Requires a plan with bulk endpoints enabled. Your current plan does not include bulk endpoints โ€” calls will return 403. ## Claude Desktop Quick Installation Install path detected from listing signals. Uses `npx` (confidence: high): ```json "mcpServers": { "mcp-server": { "command": "npx", "args": ["-y","@bitcompare/mcp-server"], "env": { "BITCOMPARE_API_KEY": "" } } } ``` **Requires environment variables:** `BITCOMPARE_API_KEY` โ€” the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for). ## Documentation & 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](https://modelcontextprotocol.io) โ€” works with Claude Desktop, Claude Code, Claude.ai, and any MCP-compatible agent. **One npm install, eighteen tools, one API key.** ```bash npx -y @bitcompare/mcp-server ``` **Requires a Bitcompare Pro or Enterprise plan.** Get a `ck_live_*` key at . ## 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: ยท machine-readable: ยท agent manifest: . ## Install You don't need to install it โ€” run via `npx`: ```bash 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`): ```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`: ```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: ```bash 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 ` โ€” 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`](https://www.npmjs.com/package/@bitcompare/mcp-server). This repository mirrors the published package and its container for public discovery and hosted introspection. ## Support - Documentation: - Issues: - Email: ## License MIT โ€” see [LICENSE](https://github.com/bitcompare/mcp-server/blob/HEAD/LICENSE).