Kraken MCP Connector

Server MCP remoto che espone i dati di mercato pubblici di Kraken (spot) come connettore personalizzato per Claude. Stesso ruolo del connettore Crypto.com già presente nel catalogo di claude.ai, ma ospitato da noi.

• Trasporto Streamable HTTP (endpoint /mcp), stateless, nessuna sessione da mantenere.

• Nessuna chiave API: usa solo gli endpoint pubblici di Kraken. Sola lettura.

• Funziona anche in locale via stdio (Claude Desktop, Claude Code).

• Pronto per Docker, Fly.io, Render, Railway o qualsiasi host Node 20+.

Tool esposti

Le coppie si possono scrivere come BTC/USD, BTCUSD, XBTUSD, XXBTZUSD o in stile Crypto.com BTC_USDT: il server prova le varianti e, se Kraken risponde "Unknown asset pair", riprova con i codici storici (XBT, XDG).

I prezzi sono restituiti come stringhe, esattamente come li manda Kraken, per non introdurre arrotondamenti.

Related MCP server: polymarket-book-mcp

Avvio locale

npm install
npm run dev            # http://127.0.0.1:3000/mcp
curl http://127.0.0.1:3000/healthz

Test (usano un finto Kraken locale, non serve rete):

npm test

Smoke test contro il vero Kraken, a server avviato:

npm run smoke                                  # locale
npm run smoke -- https://TUO-HOST/mcp          # deployment

Deploy

Il server ascolta su PORT (default 3000) e HOST (default 0.0.0.0). Tutte le variabili sono in .env.example.

Docker (qualsiasi host)

docker build -t kraken-mcp-connector .
docker run --rm -p 3000:3000 kraken-mcp-connector

Fly.io

# cambia `app` in fly.toml con un nome libero, poi:
fly launch --no-deploy --copy-config
fly deploy
fly status      # l'URL sarà https://<app>.fly.dev/mcp

Render

"New +" → "Blueprint", scegli questo repo: render.yaml crea il servizio dal Dockerfile. L'URL sarà https://<servizio>.onrender.com/mcp.

Railway

"New project" → "Deploy from GitHub repo": Railway rileva il Dockerfile. Genera un dominio pubblico dalle impostazioni del servizio e usa https://<dominio>/mcp.

Collegarlo a Claude

claude.ai (connettore personalizzato)

1. Verifica che https://TUO-HOST/healthz risponda {"ok":true}.

2. Su claude.ai: Customize → Connectors → "+" → Add custom connector.

3. Nome: Kraken. URL: https://TUO-HOST/mcp. Lascia vuoti i campi OAuth.

4. Salva e attiva il connettore nella chat.

Sui piani Team ed Enterprise il connettore va prima aggiunto all'organizzazione da un Owner, poi ogni utente lo abilita.

Nota: l'interfaccia di claude.ai non permette di impostare header personalizzati, quindi per claude.ai il server va lasciato senza MCP_BEARER_TOKEN. I dati sono comunque pubblici.

Claude Code

claude mcp add --transport http kraken https://TUO-HOST/mcp
# con token (se MCP_BEARER_TOKEN è impostato sul server):
claude mcp add --transport http kraken https://TUO-HOST/mcp --header "Authorization: Bearer IL-TUO-TOKEN"

Claude Desktop (stdio, senza deploy)

npm run build

Poi in claude_desktop_config.json:

{
  "mcpServers": {
    "kraken": {
      "command": "node",
      "args": ["/percorso/assoluto/kraken-mcp-connector/dist/stdio.js"]
    }
  }
}

Variabili d'ambiente

Limiti e note

• Solo endpoint pubblici: niente saldi, ordini o prelievi. Per questo non servono chiavi e non c'è nulla da rubare sul server.

• Kraken limita le chiamate pubbliche per IP. Il throttle e la cache interni bastano per un uso conversazionale; per carichi alti alza KRAKEN_CACHE_TTL_MS.

• Il server è stateless: ogni richiesta HTTP crea un'istanza MCP nuova. Si può replicare su più macchine senza coordinamento.

• Il trasporto SSE legacy non è servito. Claude usa Streamable HTTP.

Struttura

src/kraken.ts   client REST Kraken: normalizzazione coppie, throttle, cache, errori
src/tools.ts    definizione dei tool MCP e formattazione delle risposte
src/http.ts     entry point remoto (Streamable HTTP, /healthz, bearer opzionale)
src/stdio.ts    entry point locale (stdio)
test/           mock di Kraken + test unitari ed end-to-end con il client MCP
scripts/smoke.ts  verifica dal vivo contro api.kraken.com

Licenza

MIT.