Bitculator

Bitculator MCP Server

bitculator.com · MCP documentation · Get an MCP key Official MCP Registry · Smithery · Glama

Live and historical crypto market data for AI agents: prices, OHLCV history, sentiment indices, technical indicators, exchanges, liquidations and conversions, as 19 read-only tools.

It is a hosted, remote MCP server: there is nothing to install or run. Point any MCP client that supports remote servers over Streamable HTTP at the endpoint below and add your key.

Get a key

Create a key in the MCP console. The free MCP plan works, no card required. MCP keys are their own product: Data API keys and widget keys are rejected with 401 unauthenticated.

Keep the key out of shared files you commit: put it in your client's settings or an environment variable.

Connect

Claude Code

claude mcp add --transport http bitculator \
    https://bitculator.com/mcp \
    --header "Authorization: Bearer YOUR_API_KEY"

Cursor

This repository is also a Cursor plugin (.cursor-plugin/plugin.json): it asks for your MCP key once (stored by Cursor, never in this repo) and adds the server and the bitculator skill. Or configure it by hand in ~/.cursor/mcp.json:

{
  "mcpServers": {
    "bitculator": {
      "url": "https://bitculator.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

VS Code (.vscode/mcp.json)

{
  "servers": {
    "bitculator": {
      "type": "http",
      "url": "https://bitculator.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Claude API (MCP connector)

curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: mcp-client-2025-11-20" \
  -d '{
    "model": "claude-opus-4-8",
    "max_tokens": 1024,
    "mcp_servers": [{
      "type": "url",
      "url": "https://bitculator.com/mcp",
      "name": "bitculator",
      "authorization_token": "YOUR_API_KEY"
    }],
    "tools": [{ "type": "mcp_toolset", "mcp_server_name": "bitculator" }],
    "messages": [{ "role": "user", "content": "How is the crypto market today?" }]
  }'

Smithery and other gateways

On Smithery, enter your MCP key in the connection form. Gateways that reserve the Authorization header for their own sign-in can send the same key as an X-API-Key header instead.

Tools

Every tool is read-only and publishes an outputSchema; results come back as text and as structuredContent.

• search_coins: Resolve a coin by name or symbol to its slug, with a ranked market summary per match
• get_coin: Full profile for one coin: supplies, rank, all-time high/low, valuation, links, contracts
• get_prices: Current prices for up to 100 coins in one call, optionally converted to a fiat currency
• get_price_history: OHLCV candles for a coin over a date range
• get_historical_price: The price of one coin on a specific past date
• get_top_movers: The biggest gainers or losers over the last 24 hours or 7 days
• get_trending_coins: The coins currently drawing the most attention on Bitculator
• get_global_market: Whole-market snapshot: market cap, volume, dominance, counts, Fear & Greed
• get_global_history: Time series of the total crypto market cap or total volume
• get_fear_greed: The Fear & Greed index for the whole market or for one coin
• get_altseason_index: Whether altcoins are outperforming Bitcoin right now
• convert_currency: Convert an amount between crypto and fiat currencies at live rates
• list_exchanges: Ranked exchanges with 24h volume, volume dominance and pair/asset counts
• get_exchange: Full profile for one exchange: rank, volume, dominance, pairs, assets, links
• get_exchange_trust_score: An exchange's trust score (0-10) with its 13-factor breakdown
• get_coin_markets: Where a coin trades: its tickers across exchanges, sorted by volume
• get_coin_technicals: Technical snapshot for a coin: RSI, MACD, SMA, ADX, MFI, CCI, OBV, VWAP and more
• get_liquidations_summary: Today's futures liquidation totals with the long/short split
• calculate_dca: Backtest a dollar-cost-averaging plan against real price history

Prices, rates and supplies are returned as decimal strings, so no precision is lost. Some tools need a paid MCP plan; the MCP page lists which.

More

• MCP documentation
• Service status and API changelog
• Machine-readable: /.well-known/mcp.json and /.well-known/mcp/server-card.json
• Prefer plain HTTP? The same data is available through the Data API and its official SDKs.

License

The contents of this repository (documentation and configuration) are MIT licensed. The Bitculator service itself is subject to the Bitculator terms.