Dati crypto live per il tuo assistente AI

Il server MCP di Bitculator espone la Data API come 19 strumenti curati e in sola lettura tramite il Model Context Protocol, uno standard aperto. Connettiti una volta e il tuo assistente risponde con prezzi live, storico, sentiment e intelligence sugli exchange.

MCP (Model Context Protocol) è lo standard aperto che i client AI usano per raggiungere strumenti esterni. Qualsiasi client che supporta server remoti su Streamable HTTP può usare Bitculator — le sezioni qui sotto coprono i più diffusi. Tutti i prezzi, i tassi, i market cap e le supply vengono restituiti come decimal strings per preservare la precisione, esattamente come nella REST API.

Autenticazione

Il server si autentica con le stesse chiavi della Data API: crea una chiave con l'abilità data-api nella console per sviluppatori (il piano gratuito funziona — nessuna carta richiesta) e inviala come header Bearer su ogni richiesta. Le chiavi embed vengono rifiutate.

Authorization: Bearer YOUR_API_KEY

Le richieste senza una chiave valida ricevono 401 unauthenticated. Le chiavi sono segreti — configurale nelle impostazioni del tuo client o in una variabile d'ambiente, mai in file condivisi di cui fai il commit.

Claude Code

Un solo comando registra il server per il tuo progetto (oppure aggiungi --scope user per renderlo disponibile ovunque). Claude sceglie automaticamente lo strumento giusto quando chiedi del mercato.

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

Cursor

Aggiungi il server a ~/.cursor/mcp.json (globale) o a .cursor/mcp.json in un progetto. Gli strumenti compaiono nell'agente di Cursor appena il file viene salvato.

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

VS Code

Aggiungi il server a .vscode/mcp.json nel tuo workspace. La modalità agente di GitHub Copilot elenca automaticamente gli strumenti Bitculator.

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

Claude API

Stai costruendo la tua app sull'API di Anthropic? Il connettore MCP raggiunge il server direttamente da una chiamata alla Messages API — passa la tua chiave Bitculator come 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 si connette ai server MCP remoti tramite la developer mode:

1. Abilita la developer mode nelle impostazioni di ChatGPT (Apps & Connectors → Advanced).
2. Aggiungi un connettore con l'URL del server https://bitculator.com/mcp.
3. L'autenticazione dei connettori di ChatGPT è basata su OAuth — gli header con API key non sono ancora supportati lì, quindi usa un client capace di accesso senza autenticazione oppure le superfici Claude per l'accesso basato su chiave.

Un flusso OAuth (e con esso il pieno supporto delle directory di ChatGPT e Claude) è nella roadmap. I client basati su chiave — Claude Code, Cursor, VS Code, la Claude API — funzionano già oggi.

Quota e limiti

MCP è una superficie di consumo della Data API — non esistono fattura o pool MCP separati.

• Ogni chiamata a uno strumento conta come una richiesta alla Data API sulla quota mensile del tuo piano.
• Il limite di burst al minuto del tuo piano si applica per ogni chiamata a strumento (Free 30, Starter 60, Pro 120).
• Superata la quota, gli strumenti restituiscono un errore rate_limited che dice all'assistente quando il pool si rinnova. Gli endpoint riservati ai piani superiori restituiscono plan_required.
• L'handshake del protocollo (initialize, tools/list) è gratuito — solo le chiamate agli strumenti attingono al pool.

Framework per agenti

Stai costruendo il tuo agente? Ogni framework principale include un client MCP che si connette via Streamable HTTP con header Bearer - gli snippet qui sotto caricano tutti i 19 strumenti come funzioni native.

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)

Riferimento degli strumenti

Tutti i 19 strumenti sono in sola lettura. I parametri rispecchiano i corrispondenti endpoint della Data API — stessa validazione, stessi vincoli di piano, stessa precisione a stringhe decimali.