Live cryptodata voor je AI-assistent

De Bitculator MCP-server stelt de Data API beschikbaar als 19 gecureerde, alleen-lezen tools via het open Model Context Protocol. Verbind één keer en je assistent antwoordt met live prijzen, historie, sentiment en exchange-intelligence.

MCP (Model Context Protocol) is de open standaard waarmee AI-clients externe tools bereiken. Elke client die remote servers via Streamable HTTP ondersteunt kan Bitculator gebruiken — de secties hieronder behandelen de populairste. Alle prijzen, koersen, marketcaps en supplies worden teruggegeven als decimal strings om precisie te behouden, precies zoals bij de REST API.

Authenticatie

De server authenticeert met dezelfde keys als de Data API: maak een key met de data-api-ability aan in de developerconsole (het gratis plan werkt — geen kaart nodig) en stuur hem als Bearer-header mee met elk verzoek. Embed-keys worden geweigerd.

Authorization: Bearer YOUR_API_KEY

Verzoeken zonder geldige key krijgen 401 unauthenticated. Keys zijn geheimen — configureer ze in de instellingen van je client of in een omgevingsvariabele, nooit in gedeelde bestanden die je commit.

Claude Code

Eén commando registreert de server voor je project (of voeg --scope user toe om hem overal beschikbaar te maken). Claude kiest automatisch de juiste tool wanneer je naar de markt vraagt.

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

Cursor

Voeg de server toe aan ~/.cursor/mcp.json (globaal) of .cursor/mcp.json in een project. De tools verschijnen in de agent van Cursor zodra het bestand is opgeslagen.

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

VS Code

Voeg de server toe aan .vscode/mcp.json in je workspace. De agent mode van GitHub Copilot toont de Bitculator-tools automatisch.

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

Claude API

Bouw je je eigen app op de Anthropic API? De MCP-connector bereikt de server rechtstreeks vanuit een Messages API-call — geef je Bitculator-key mee als de authorization_token.

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?" }]
  }'

ChatGPT

ChatGPT verbindt met remote MCP-servers via developer mode:

1. Schakel developer mode in via de instellingen van ChatGPT (Apps & Connectors → Advanced).
2. Voeg een connector toe met de server-URL https://bitculator.com/mcp.
3. De connector-authenticatie van ChatGPT is OAuth-gebaseerd — API-key-headers worden daar nog niet ondersteund, gebruik dus een client die zonder auth kan of de Claude-oppervlakken voor key-gebaseerde toegang.

Een OAuth-flow (en daarmee volledige ondersteuning voor de ChatGPT- en Claude-directories) staat op de roadmap. Key-gebaseerde clients — Claude Code, Cursor, VS Code, de Claude API — werken vandaag al.

Quota & limieten

MCP is een verbruiksoppervlak van de Data API — er is geen aparte MCP-factuur of -pool.

• Elke tool-call telt als één Data API-request tegen het maandelijkse quotum van je plan.
• De burst-limiet per minuut van je plan geldt per tool-call (Free 30, Starter 60, Pro 120).
• Boven je quotum geven tools een rate_limited-fout terug die de assistent vertelt wanneer de pool reset. Plan-gebonden endpoints geven plan_required terug.
• De protocol-handshake (initialize, tools/list) is gratis — alleen tool-calls putten uit de pool.

Agent-frameworks

Bouw je je eigen agent? Elk groot framework levert een MCP-client die verbindt via Streamable HTTP met een Bearer-header - de snippets hieronder laden alle 19 tools als native functies.

from agents.mcp import MCPServerStreamableHttp

async with MCPServerStreamableHttp(
    name="Bitculator",
    params={"url": "https://bitculator.com/mcp",
            "headers": {"Authorization": "Bearer YOUR_API_KEY"}},
) as server:
    agent = Agent(name="analyst", mcp_servers=[server])

import { createMCPClient } from '@ai-sdk/mcp';

const mcp = await createMCPClient({
  transport: {
    type: 'http',
    url: 'https://bitculator.com/mcp',
    headers: { Authorization: 'Bearer YOUR_API_KEY' },
  },
});
const tools = await mcp.tools();

from langchain_mcp_adapters.client import MultiServerMCPClient

client = MultiServerMCPClient({"bitculator": {
    "transport": "http",
    "url": "https://bitculator.com/mcp",
    "headers": {"Authorization": "Bearer YOUR_API_KEY"},
}})
tools = await client.get_tools()

from llama_index.tools.mcp import BasicMCPClient, McpToolSpec

client = BasicMCPClient("https://bitculator.com/mcp",
                        headers={"Authorization": "Bearer YOUR_API_KEY"})
tools = await McpToolSpec(client=client).to_tool_list_async()

import { MCPClient } from '@mastra/mcp';

const mcp = new MCPClient({ servers: { bitculator: {
    url: new URL('https://bitculator.com/mcp'),
    requestInit: { headers: { Authorization: 'Bearer YOUR_API_KEY' } },
}}});
const tools = await mcp.getTools();

from semantic_kernel.connectors.mcp import MCPStreamableHttpPlugin

async with MCPStreamableHttpPlugin(
    name="Bitculator",
    url="https://bitculator.com/mcp",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
) as plugin:
    kernel.add_plugin(plugin)

Tool-referentie

Alle 19 tools zijn alleen-lezen. Parameters spiegelen de bijbehorende Data API-endpoints — dezelfde validatie, dezelfde plan-poorten, dezelfde precisie in decimale strings.