{"server":"bitcompare","endpoint":"https://api.bitcompare.net/mcp","authentication":{"type":"bearer","header":"Authorization","keyPrefix":"ck_live_","keyUrl":"https://pro.bitcompare.net/dashboard/keys"},"plan":"requires Pro or Enterprise","npmPackage":"@bitcompare/mcp-server","tools":[{"name":"get_rates","title":"Get current rates","description":"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.","category":"rates","requiredPlan":"pro","endpoint":{"method":"GET","path":"/api/v1/rates"},"inputJsonSchema":{"type":"object","properties":{"symbol":{"type":"string","description":"Filter by coin symbol (e.g. \"btc\")"},"category":{"type":"string","description":"Filter by product category (e.g. \"savings\", \"lending\")"},"provider":{"type":"string","description":"Filter by provider slug"},"limit":{"type":"integer","minimum":1,"maximum":500,"description":"Max results, default 100"}},"additionalProperties":true},"exampleInput":{"symbol":"btc","category":"savings","limit":10},"outputJsonSchema":{"type":"object","properties":{"rates":{"type":"array","items":{"type":"object","properties":{"provider":{"type":"string","description":"Provider slug, e.g. `nexo`"},"symbol":{"type":"string","description":"Coin symbol, e.g. `btc`"},"category":{"type":"string","enum":["savings","lending","staking","borrowing"],"description":"Product category"},"apy":{"type":"number","description":"Annual percentage yield as a decimal (0.05 = 5%)"},"updatedAt":{"type":"string","description":"ISO-8601 timestamp of the most recent rate refresh"}},"required":["provider","symbol","category","apy"],"additionalProperties":true},"description":"Matching rate entries"}},"required":["rates"],"additionalProperties":true},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"get_rate_by_symbol","title":"Get rates for a single symbol","description":"Fetch all provider rates for a specific coin symbol. Optionally filter by category.","category":"rates","requiredPlan":"pro","endpoint":{"method":"GET","path":"/api/v1/rates/eth"},"inputJsonSchema":{"type":"object","properties":{"symbol":{"type":"string","description":"Coin symbol, e.g. \"btc\" or \"eth\""},"category":{"type":"string","description":"Filter to a single product category (e.g. \"savings\", \"lending\", \"staking\")"}},"required":["symbol"],"additionalProperties":true},"exampleInput":{"symbol":"eth","category":"lending"},"outputJsonSchema":{"type":"object","properties":{"rates":{"type":"array","items":{"type":"object","properties":{"provider":{"type":"string","description":"Provider slug, e.g. `nexo`"},"symbol":{"type":"string","description":"Coin symbol, e.g. `btc`"},"category":{"type":"string","enum":["savings","lending","staking","borrowing"],"description":"Product category"},"apy":{"type":"number","description":"Annual percentage yield as a decimal (0.05 = 5%)"},"updatedAt":{"type":"string","description":"ISO-8601 timestamp of the most recent rate refresh"}},"required":["provider","symbol","category","apy"],"additionalProperties":true},"description":"Matching rate entries"}},"required":["rates"],"additionalProperties":true},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"get_rate_history","title":"Historical rates","description":"Historical rate timeseries for a symbol. Pro plans get up to 5 years; lower plans are clamped server-side.","category":"rates","requiredPlan":"pro","endpoint":{"method":"GET","path":"/api/v1/rates/btc/history"},"inputJsonSchema":{"type":"object","properties":{"symbol":{"type":"string","description":"Coin symbol"},"provider":{"type":"string","description":"Provider slug to scope to"},"days":{"type":"integer","minimum":1,"maximum":1825,"description":"Days of history. Clamped to the plan limit (7 Free, 1825 Pro)."}},"required":["symbol"],"additionalProperties":true},"exampleInput":{"symbol":"btc","days":30},"outputJsonSchema":{"type":"object","properties":{"symbol":{"type":"string"},"provider":{"type":"string"},"points":{"type":"array","items":{"type":"object","properties":{"timestamp":{"type":"string","description":"ISO-8601 timestamp of the data point"},"value":{"type":"number","description":"The recorded numeric value"}},"required":["timestamp","value"],"additionalProperties":true},"description":"Time-ordered rate observations (oldest → newest)"}},"required":["symbol","points"],"additionalProperties":true},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"list_providers","title":"List rate providers","description":"All rate providers, optionally filtered by product category.","category":"rates","requiredPlan":"pro","endpoint":{"method":"GET","path":"/api/v1/providers"},"inputJsonSchema":{"type":"object","properties":{"category":{"type":"string","description":"Filter to providers that offer this category (e.g. \"savings\", \"lending\")"},"limit":{"type":"integer","minimum":1,"maximum":500,"description":"Max results, default 100"}},"additionalProperties":true},"exampleInput":{"category":"savings"},"outputJsonSchema":{"type":"object","properties":{"providers":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string","description":"Stable identifier (e.g. `nexo`)"},"name":{"type":"string","description":"Display name"},"categories":{"type":"array","items":{"type":"string"},"description":"Categories this provider offers"}},"required":["slug","name"],"additionalProperties":true}}},"required":["providers"],"additionalProperties":true},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"get_coin","title":"Get coin metadata","description":"Full metadata for a coin: description, links, categories, market data, developer stats.","category":"coins","requiredPlan":"pro","endpoint":{"method":"GET","path":"/api/v1/coins/bitcoin"},"inputJsonSchema":{"type":"object","properties":{"coinId":{"type":"string","description":"Canonical coin id or slug (e.g. \"bitcoin\")"}},"required":["coinId"],"additionalProperties":true},"exampleInput":{"coinId":"bitcoin"},"outputJsonSchema":{"type":"object","properties":{"id":{"type":"string","description":"Canonical coin ID (e.g. `bitcoin`)"},"symbol":{"type":"string","description":"Trading symbol (e.g. `btc`)"},"name":{"type":"string","description":"Human-readable name (e.g. `Bitcoin`)"},"marketCap":{"type":"number","description":"Market cap in USD"},"rank":{"type":"integer","description":"Market cap rank (1 = largest)"},"price":{"type":"number","description":"Current spot price in USD"}},"required":["id","symbol","name"],"additionalProperties":true},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"list_coins","title":"List coins","description":"Paginated list of coins with optional name/symbol search.","category":"coins","requiredPlan":"pro","endpoint":{"method":"GET","path":"/api/v1/coins"},"inputJsonSchema":{"type":"object","properties":{"page":{"type":"integer","minimum":1,"description":"Page, default 1"},"limit":{"type":"integer","minimum":1,"maximum":500,"description":"Page size, default 20"},"search":{"type":"string","description":"Search by name or symbol"}},"additionalProperties":true},"exampleInput":{"search":"eth","limit":10},"outputJsonSchema":{"type":"object","properties":{"coins":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Canonical coin ID (e.g. `bitcoin`)"},"symbol":{"type":"string","description":"Trading symbol (e.g. `btc`)"},"name":{"type":"string","description":"Human-readable name (e.g. `Bitcoin`)"},"marketCap":{"type":"number","description":"Market cap in USD"},"rank":{"type":"integer","description":"Market cap rank (1 = largest)"},"price":{"type":"number","description":"Current spot price in USD"}},"required":["id","symbol","name"],"additionalProperties":true}}},"required":["coins"],"additionalProperties":true},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"top_coins","title":"Top coins by market cap","description":"Top N coins ordered by market capitalisation.","category":"coins","requiredPlan":"pro","endpoint":{"method":"GET","path":"/api/v1/coins/top"},"inputJsonSchema":{"type":"object","properties":{"limit":{"type":"integer","minimum":1,"maximum":500,"description":"Number of coins, default 100"}},"additionalProperties":true},"exampleInput":{"limit":10},"outputJsonSchema":{"type":"object","properties":{"coins":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Canonical coin ID (e.g. `bitcoin`)"},"symbol":{"type":"string","description":"Trading symbol (e.g. `btc`)"},"name":{"type":"string","description":"Human-readable name (e.g. `Bitcoin`)"},"marketCap":{"type":"number","description":"Market cap in USD"},"rank":{"type":"integer","description":"Market cap rank (1 = largest)"},"price":{"type":"number","description":"Current spot price in USD"}},"required":["id","symbol","name"],"additionalProperties":true}}},"required":["coins"],"additionalProperties":true},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"similar_coins","title":"Similar coins","description":"Coins related to the given coin by category/sector similarity.","category":"coins","requiredPlan":"pro","endpoint":{"method":"GET","path":"/api/v1/coins/bitcoin/similar"},"inputJsonSchema":{"type":"object","properties":{"coinId":{"type":"string","description":"Canonical coin id to find related coins for (e.g. \"bitcoin\")"},"limit":{"type":"integer","minimum":1,"maximum":50,"description":"Max related coins to return, default 10"}},"required":["coinId"],"additionalProperties":true},"exampleInput":{"coinId":"bitcoin","limit":5},"outputJsonSchema":{"type":"object","properties":{"coins":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Canonical coin ID (e.g. `bitcoin`)"},"symbol":{"type":"string","description":"Trading symbol (e.g. `btc`)"},"name":{"type":"string","description":"Human-readable name (e.g. `Bitcoin`)"},"marketCap":{"type":"number","description":"Market cap in USD"},"rank":{"type":"integer","description":"Market cap rank (1 = largest)"},"price":{"type":"number","description":"Current spot price in USD"}},"required":["id","symbol","name"],"additionalProperties":true}}},"required":["coins"],"additionalProperties":true},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"coin_markets","title":"Markets trading a coin","description":"Exchanges and trading pairs for a coin, with prices and volumes.","category":"coins","requiredPlan":"pro","endpoint":{"method":"GET","path":"/api/v1/coins/ethereum/markets"},"inputJsonSchema":{"type":"object","properties":{"coinId":{"type":"string","description":"Canonical coin id whose markets to fetch (e.g. \"ethereum\")"},"limit":{"type":"integer","minimum":1,"maximum":200,"description":"Max exchange/pair rows to return, default 50"}},"required":["coinId"],"additionalProperties":true},"exampleInput":{"coinId":"ethereum","limit":20},"outputJsonSchema":{"type":"object","properties":{"coinId":{"type":"string"},"markets":{"type":"array","items":{"type":"object","properties":{"exchange":{"type":"string","description":"Exchange / venue name"},"pair":{"type":"string","description":"Trading pair, e.g. `BTC/USDT`"},"price":{"type":"number","description":"Last traded price"},"volume24h":{"type":"number","description":"24h trading volume"}},"required":["exchange","pair"],"additionalProperties":true}}},"required":["coinId","markets"],"additionalProperties":true},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"coin_history","title":"Historical coin price chart","description":"Historical price timeseries for a coin symbol.","category":"coins","requiredPlan":"pro","endpoint":{"method":"GET","path":"/api/v1/coins/history/btc"},"inputJsonSchema":{"type":"object","properties":{"symbol":{"type":"string","description":"Coin symbol (e.g. \"btc\")"},"days":{"type":"integer","minimum":1,"maximum":1825,"description":"Days of history"}},"required":["symbol"],"additionalProperties":true},"exampleInput":{"symbol":"btc","days":30},"outputJsonSchema":{"type":"object","properties":{"symbol":{"type":"string"},"points":{"type":"array","items":{"type":"object","properties":{"timestamp":{"type":"string","description":"ISO-8601 timestamp of the data point"},"value":{"type":"number","description":"The recorded numeric value"}},"required":["timestamp","value"],"additionalProperties":true},"description":"Price points, oldest → newest"}},"required":["symbol","points"],"additionalProperties":true},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"get_price","title":"Aggregated exchange price","description":"Current aggregated price for one or more symbols, computed from multiple exchange feeds.","category":"prices","requiredPlan":"pro","endpoint":{"method":"GET","path":"/api/v1/prices"},"inputJsonSchema":{"type":"object","properties":{"symbols":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Single symbol or array of symbols (e.g. \"btc\" or [\"btc\",\"eth\"])"},"vs":{"type":"string","description":"Quote currency, default \"usd\""}},"required":["symbols"],"additionalProperties":true},"exampleInput":{"symbols":["btc","eth"],"vs":"usd"},"outputJsonSchema":{"type":"object","properties":{"prices":{"type":"array","items":{"type":"object","properties":{"symbol":{"type":"string","description":"Coin symbol queried"},"priceUsd":{"type":"number","description":"Aggregated USD spot price"},"updatedAt":{"type":"string","description":"ISO-8601 timestamp of the price aggregation"}},"required":["symbol","priceUsd"],"additionalProperties":true}}},"required":["prices"],"additionalProperties":true},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"market_summary","title":"Global market summary","description":"One-call summary of total market cap, 24h volume, BTC/ETH dominance, and recent trend.","category":"market","requiredPlan":"pro","endpoint":{"method":"GET","path":"/api/v1/global-stats/summary"},"inputJsonSchema":{"type":"object","properties":{},"additionalProperties":false},"exampleInput":{},"outputJsonSchema":{"type":"object","properties":{"totalMarketCapUsd":{"type":"number","description":"Combined market cap of all tracked coins"},"volume24hUsd":{"type":"number","description":"Combined 24h trading volume"},"btcDominance":{"type":"number","description":"BTC share of total market cap, 0-100"},"ethDominance":{"type":"number","description":"ETH share of total market cap, 0-100"},"trend24h":{"type":"number","description":"24h trend as a decimal (0.02 = +2%)"}},"required":["totalMarketCapUsd","volume24hUsd","btcDominance","ethDominance"],"additionalProperties":true},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"fear_greed_index","title":"Fear & Greed index","description":"Current Fear & Greed index value and historical trend.","category":"market","requiredPlan":"pro","endpoint":{"method":"GET","path":"/api/v1/global-stats/fear-greed"},"inputJsonSchema":{"type":"object","properties":{},"additionalProperties":false},"exampleInput":{},"outputJsonSchema":{"type":"object","properties":{"value":{"type":"integer","minimum":0,"maximum":100,"description":"Current index, 0 (extreme fear) to 100 (extreme greed)"},"classification":{"type":"string","description":"Label, e.g. `Greed`, `Neutral`, `Extreme Fear`"},"updatedAt":{"type":"string"},"history":{"type":"array","items":{"type":"object","properties":{"timestamp":{"type":"string","description":"ISO-8601 timestamp of the data point"},"value":{"type":"number","description":"The recorded numeric value"}},"required":["timestamp","value"],"additionalProperties":true},"description":"Recent trend of the index"}},"required":["value","classification"],"additionalProperties":true},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"top_movers","title":"Top gainers/losers","description":"Biggest 24h gainers and losers within a rank segment.","category":"market","requiredPlan":"pro","endpoint":{"method":"GET","path":"/api/v1/global-stats/movers"},"inputJsonSchema":{"type":"object","properties":{"segment":{"type":"string","enum":["top10","top100","top1000"],"description":"Rank segment, default \"top100\""},"limit":{"type":"integer","minimum":1,"maximum":50,"description":"Number of gainers and losers to return on each side, default 10"}},"additionalProperties":true},"exampleInput":{"segment":"top100","limit":10},"outputJsonSchema":{"type":"object","properties":{"gainers":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Canonical coin ID (e.g. `bitcoin`)"},"symbol":{"type":"string","description":"Trading symbol (e.g. `btc`)"},"name":{"type":"string","description":"Human-readable name (e.g. `Bitcoin`)"},"marketCap":{"type":"number","description":"Market cap in USD"},"rank":{"type":"integer","description":"Market cap rank (1 = largest)"},"price":{"type":"number","description":"Current spot price in USD"}},"required":["id","symbol","name"],"additionalProperties":true},"description":"Top 24h gainers in the requested segment"},"losers":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Canonical coin ID (e.g. `bitcoin`)"},"symbol":{"type":"string","description":"Trading symbol (e.g. `btc`)"},"name":{"type":"string","description":"Human-readable name (e.g. `Bitcoin`)"},"marketCap":{"type":"number","description":"Market cap in USD"},"rank":{"type":"integer","description":"Market cap rank (1 = largest)"},"price":{"type":"number","description":"Current spot price in USD"}},"required":["id","symbol","name"],"additionalProperties":true},"description":"Top 24h losers in the requested segment"}},"required":["gainers","losers"],"additionalProperties":true},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"stablecoin_index","title":"Stablecoin stability leaderboard","description":"Ranked stablecoin leaderboard with stability scores, peg deviation, and market cap.","category":"stablecoins","requiredPlan":"pro","endpoint":{"method":"GET","path":"/api/v1/stablecoins/index"},"inputJsonSchema":{"type":"object","properties":{"limit":{"type":"integer","minimum":1,"maximum":200,"description":"Default 50"}},"additionalProperties":true},"exampleInput":{"limit":20},"outputJsonSchema":{"type":"object","properties":{"stablecoins":{"type":"array","items":{"type":"object","properties":{"symbol":{"type":"string","description":"Stablecoin symbol (e.g. `usdc`)"},"name":{"type":"string","description":"Human-readable name"},"marketCap":{"type":"number","description":"Market cap in USD"},"pegDeviation":{"type":"number","description":"Current peg deviation from target (typically $1.00) in basis points"},"stabilityScore":{"type":"number","description":"Stability score 0-100, higher is more stable"}},"required":["symbol","name"],"additionalProperties":true},"description":"Ranked stablecoin leaderboard"}},"required":["stablecoins"],"additionalProperties":true},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"stablecoin_peg_stability","title":"Stablecoin peg stability","description":"Peg deviation history and stability stats for a stablecoin.","category":"stablecoins","requiredPlan":"pro","endpoint":{"method":"GET","path":"/api/v1/stablecoins/usdc/peg-stability"},"inputJsonSchema":{"type":"object","properties":{"symbol":{"type":"string","description":"Stablecoin symbol (e.g. \"usdt\", \"usdc\")"},"window":{"type":"string","enum":["7d","30d","90d"],"description":"Stability window, default \"30d\""}},"required":["symbol"],"additionalProperties":true},"exampleInput":{"symbol":"usdc","window":"30d"},"outputJsonSchema":{"type":"object","properties":{"symbol":{"type":"string"},"pegTarget":{"type":"number","description":"Target peg in USD (typically 1.0)"},"deviation":{"type":"number","description":"Current peg deviation in basis points"},"history":{"type":"array","items":{"type":"object","properties":{"timestamp":{"type":"string","description":"ISO-8601 timestamp of the data point"},"value":{"type":"number","description":"The recorded numeric value"}},"required":["timestamp","value"],"additionalProperties":true},"description":"Recent peg deviation samples"}},"required":["symbol","pegTarget","deviation","history"],"additionalProperties":true},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"resolve_symbol","title":"Resolve symbol to canonical coin","description":"Map an exchange-specific or ambiguous symbol to bitcompare's canonical coin id. Useful when an exchange uses a non-standard ticker.","category":"symbols","requiredPlan":"pro","endpoint":{"method":"GET","path":"/api/v1/symbols/resolve"},"inputJsonSchema":{"type":"object","properties":{"symbol":{"type":"string","description":"Exchange-specific or ambiguous symbol"},"context":{"type":"string","description":"Source exchange or quote currency to disambiguate (e.g. \"kraken\", \"binance\")"}},"required":["symbol"],"additionalProperties":true},"exampleInput":{"symbol":"xbt","context":"kraken"},"outputJsonSchema":{"type":"object","properties":{"input":{"type":"string","description":"The raw symbol that was queried"},"coinId":{"type":"string","description":"Canonical Bitcompare coin ID"},"symbol":{"type":"string","description":"Canonical symbol"},"name":{"type":"string","description":"Coin display name"}},"required":["input","coinId","symbol","name"],"additionalProperties":true},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"resolve_symbols_batch","title":"Batch resolve symbols","description":"Resolve up to 100 symbols in a single request. Requires a plan with bulk endpoints enabled.","category":"symbols","requiredPlan":"pro","endpoint":{"method":"POST","path":"/api/v1/symbols/resolve/batch"},"inputJsonSchema":{"type":"object","properties":{"symbols":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":100,"description":"Up to 100 symbols to resolve in a single request"},"context":{"type":"string","description":"Source exchange or quote currency applied to every input symbol"}},"required":["symbols"],"additionalProperties":true},"exampleInput":{"symbols":["xbt","weth","wbtc"],"context":"kraken"},"outputJsonSchema":{"type":"object","properties":{"resolved":{"type":"array","items":{"type":"object","properties":{"input":{"type":"string","description":"The raw symbol that was queried"},"coinId":{"type":"string","description":"Canonical Bitcompare coin ID"},"symbol":{"type":"string","description":"Canonical symbol"},"name":{"type":"string","description":"Coin display name"}},"required":["input","coinId","symbol","name"],"additionalProperties":true}}},"required":["resolved"],"additionalProperties":true},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}}]}