Bitculator

1# Bitculator MCP Server
2 
3[bitculator.com](https://bitculator.com/en/crypto-mcp) · [MCP documentation](https://bitculator.com/en/documentation/mcp/v1) · [Get an MCP key](https://bitculator.com/user/developer/mcp)
4[Official MCP Registry](https://registry.modelcontextprotocol.io/v0/servers/com.bitculator%2Fmarket-data/versions/latest) · [Smithery](https://smithery.ai/servers/bitculator/market-data) · [Glama](https://glama.ai/mcp/connectors/com.bitculator/market-data)
5 
6Live and historical crypto market data for AI agents: prices, OHLCV history, sentiment indices,
7technical indicators, exchanges, liquidations and conversions, as **19 read-only tools**.
8 
9It is a hosted, remote MCP server: there is nothing to install or run. Point any MCP client that
10supports remote servers over Streamable HTTP at the endpoint below and add your key.
11 
12| | |
13|---|---|
14| Endpoint | `https://bitculator.com/mcp` |
15| Transport | Streamable HTTP |
16| Authentication | MCP key, as `Authorization: Bearer <key>` or `X-API-Key: <key>` |
17| Registry name | `com.bitculator/market-data` |
18 
19## Get a key
20 
21Create a key in the [MCP console](https://bitculator.com/user/developer/mcp). The free MCP plan works,
22no card required. MCP keys are their own product: Data API keys and widget keys are rejected with
23`401 unauthenticated`.
24 
25Keep the key out of shared files you commit: put it in your client's settings or an environment variable.
26 
27## Connect
28 
29### Claude Code
30 
31```bash
32claude mcp add --transport http bitculator \
33    https://bitculator.com/mcp \
34    --header "Authorization: Bearer YOUR_API_KEY"
35```
36 
37### Cursor (`~/.cursor/mcp.json`)
38 
39```json
40{
41  "mcpServers": {
42    "bitculator": {
43      "url": "https://bitculator.com/mcp",
44      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
45    }
46  }
47}
48```
49 
50### VS Code (`.vscode/mcp.json`)
51 
52```json
53{
54  "servers": {
55    "bitculator": {
56      "type": "http",
57      "url": "https://bitculator.com/mcp",
58      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
59    }
60  }
61}
62```
63 
64### Claude API (MCP connector)
65 
66```bash
67curl https://api.anthropic.com/v1/messages \
68  -H "x-api-key: $ANTHROPIC_API_KEY" \
69  -H "anthropic-version: 2023-06-01" \
70  -H "anthropic-beta: mcp-client-2025-11-20" \
71  -d '{
72    "model": "claude-opus-4-8",
73    "max_tokens": 1024,
74    "mcp_servers": [{
75      "type": "url",
76      "url": "https://bitculator.com/mcp",
77      "name": "bitculator",
78      "authorization_token": "YOUR_API_KEY"
79    }],
80    "tools": [{ "type": "mcp_toolset", "mcp_server_name": "bitculator" }],
81    "messages": [{ "role": "user", "content": "How is the crypto market today?" }]
82  }'
83```
84 
85### Smithery and other gateways
86 
87On [Smithery](https://smithery.ai/servers/bitculator/market-data), enter your MCP key in the
88connection form. Gateways that reserve the `Authorization` header for their own sign-in can send the
89same key as an `X-API-Key` header instead.
90 
91## Tools
92 
93Every tool is read-only and publishes an `outputSchema`; results come back as text and as
94`structuredContent`.
95 
96- `search_coins`: Resolve a coin by name or symbol to its slug, with a ranked market summary per match
97- `get_coin`: Full profile for one coin: supplies, rank, all-time high/low, valuation, links, contracts
98- `get_prices`: Current prices for up to 100 coins in one call, optionally converted to a fiat currency
99- `get_price_history`: OHLCV candles for a coin over a date range
100- `get_historical_price`: The price of one coin on a specific past date
101- `get_top_movers`: The biggest gainers or losers over the last 24 hours or 7 days
102- `get_trending_coins`: The coins currently drawing the most attention on Bitculator
103- `get_global_market`: Whole-market snapshot: market cap, volume, dominance, counts, Fear & Greed
104- `get_global_history`: Time series of the total crypto market cap or total volume
105- `get_fear_greed`: The Fear & Greed index for the whole market or for one coin
106- `get_altseason_index`: Whether altcoins are outperforming Bitcoin right now
107- `convert_currency`: Convert an amount between crypto and fiat currencies at live rates
108- `list_exchanges`: Ranked exchanges with 24h volume, volume dominance and pair/asset counts
109- `get_exchange`: Full profile for one exchange: rank, volume, dominance, pairs, assets, links
110- `get_exchange_trust_score`: An exchange's trust score (0-10) with its 13-factor breakdown
111- `get_coin_markets`: Where a coin trades: its tickers across exchanges, sorted by volume
112- `get_coin_technicals`: Technical snapshot for a coin: RSI, MACD, SMA, ADX, MFI, CCI, OBV, VWAP and more
113- `get_liquidations_summary`: Today's futures liquidation totals with the long/short split
114- `calculate_dca`: Backtest a dollar-cost-averaging plan against real price history
115 
116Prices, rates and supplies are returned as decimal strings, so no precision is lost. Some tools need
117a paid MCP plan; the [MCP page](https://bitculator.com/en/crypto-mcp) lists which.
118 
119## More
120 
121- [MCP documentation](https://bitculator.com/en/documentation/mcp/v1)
122- [Service status](https://bitculator.com/en/status) and [API changelog](https://bitculator.com/en/documentation/api/changelog)
123- Machine-readable: [`/.well-known/mcp.json`](https://bitculator.com/.well-known/mcp.json) and [`/.well-known/mcp/server-card.json`](https://bitculator.com/.well-known/mcp/server-card.json)
124- Prefer plain HTTP? The same data is available through the [Data API](https://bitculator.com/en/documentation/api/v1) and its [official SDKs](https://github.com/Bitculator).
125 
126## License
127 
128The contents of this repository (documentation and configuration) are MIT licensed. The Bitculator
129service itself is subject to the [Bitculator terms](https://bitculator.com/en/terms-of-service).
130