Bitculator
Bitculator MCP Server

Live kryptodata til din AI-assistent

Bitculators MCP-server eksponerer Data API'et som 19 kuraterede, skrivebeskyttede værktøjer over den åbne Model Context Protocol. Forbind én gang, og din assistent svarer med live-priser, historik, sentiment og børsindsigt.

Endpoint
https://bitculator.com/mcp
Transport
Streamable HTTP
Godkendelse
Bearer API-nøgle
Værktøjer
19 · skrivebeskyttede

MCP (Model Context Protocol) er den åbne standard, AI-klienter bruger til at nå eksterne værktøjer. Enhver klient, der understøtter fjernservere over Streamable HTTP, kan bruge Bitculator - afsnittene nedenfor dækker de mest udbredte. Alle priser, kurser, markedsværdier og forsyninger returneres som decimal strings for at bevare præcisionen, præcis som i REST API'et.

Godkendelse

Serveren godkender med de samme nøgler som Data API'et: opret en nøgle med data-api-tilladelsen i udviklerkonsollen (gratisplanen virker - intet kort påkrævet), og send den som en Bearer-header på hvert request. Embed-nøgler afvises.

HTTP-header
Authorization: Bearer YOUR_API_KEY

Requests uden en gyldig nøgle får 401 unauthenticated. Nøgler er hemmeligheder - konfigurér dem i din klients indstillinger eller en miljøvariabel, aldrig i delte filer, du committer.

Claude Code

Én kommando registrerer serveren for dit projekt (eller tilføj --scope user for at gøre den tilgængelig overalt). Claude vælger automatisk det rigtige værktøj, når du spørger til markedet.

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

Cursor

Tilføj serveren til ~/.cursor/mcp.json (globalt) eller .cursor/mcp.json i et projekt. Værktøjerne dukker op i Cursors agent, så snart filen er gemt.

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

VS Code

Tilføj serveren til .vscode/mcp.json i dit workspace. GitHub Copilots agent-tilstand viser automatisk Bitculator-værktøjerne.

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

Claude API

Bygger du din egen app på Anthropic API'et? MCP-connectoren når serveren direkte fra et Messages API-kald - send din Bitculator-nøgle som authorization_token.

POST /v1/messages
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 forbinder til eksterne MCP-servere gennem developer mode:

  1. Slå developer mode til i ChatGPTs indstillinger (Apps & Connectors → Advanced).
  2. Tilføj en connector med server-URL'en https://bitculator.com/mcp.
  3. ChatGPTs connector-godkendelse er OAuth-baseret - API-nøgle-headers understøttes ikke dér endnu, så brug en klient, der kan køre uden auth, eller Claude-fladerne til nøglebaseret adgang.

Et OAuth-flow (og dermed fuld understøttelse af ChatGPT- og Claude-katalogerne) er på roadmappet. Nøglebaserede klienter - Claude Code, Cursor, VS Code, Claude API'et - virker i dag.

Kvote & grænser

MCP er en forbrugsflade for Data API'et - der er ingen separat MCP-regning eller -pulje.

  • Hvert værktøjskald tæller som ét Data API-request mod din plans månedlige kvote.
  • Din plans burst-grænse pr. minut gælder pr. værktøjskald (Free 30, Starter 60, Pro 120).
  • Over kvoten returnerer værktøjerne en rate_limited-fejl, der fortæller assistenten, hvornår puljen nulstilles. Plan-gatede endpoints returnerer plan_required.
  • Protokol-handshaket (initialize, tools/list) er gratis - kun værktøjskald trækker fra puljen.

Agent-frameworks

Bygger du din egen agent? Alle store frameworks leverer en MCP-klient, der forbinder via Streamable HTTP med en Bearer-header - snippets herunder indlæser alle 19 værktøjer som native funktioner.

OpenAI Agents SDK

pip install openai-agents
Python
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])

Vercel AI SDK

npm i @ai-sdk/mcp
TypeScript
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();

LangChain

pip install langchain-mcp-adapters
Python
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()

LlamaIndex

pip install llama-index-tools-mcp
Python
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()

Mastra

npm i @mastra/mcp
TypeScript
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();

Semantic Kernel

pip install semantic-kernel[mcp]
Python
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)

Værktøjsreference

Alle 19 værktøjer er skrivebeskyttede. Parametrene afspejler de tilsvarende Data API-endpoints - samme validering, samme plan-gates, samme decimalstreng-præcision.

Markedsdata

Værktøj

search_coins

Slå en coin eller token op ud fra fritekst-navn eller symbol og få dens kanoniske slug, med et rangeret markedsresumé pr. match. Indgangsdøren: alle andre coin-værktøjer adresseres via slug.

Parameter Type Beskrivelse
query påkrævet string Fritekstsøgning matchet mod coin-navne og symboler.
type enum Begræns matches: coin eller token.
limit integer Maksimalt antal matches at returnere (1–50, standard 10).
Værktøj

get_coin

Fuld profil for én coin: forsyninger, rang og rangændringer, all-time high/low og afstanden dertil, fuldt udvandet værdiansættelse, links, kontrakter og beskrivelse.

Parameter Type Beskrivelse
slug påkrævet string Kanonisk coin-slug, f.eks. bitcoin.
Værktøj

get_prices

Aktuelle spotpriser for op til 100 coins i ét kald, valgfrit konverteret til en fiat-valuta. Den billigste måde at besvare prisspørgsmål på - præcis én selector er påkrævet.

Parameter Type Beskrivelse
slugs string Kommaseparerede coin-slugs - den foretrukne selector.
symbols string Kommaseparerede ticker-symboler; tvetydige symboler matches til det højest rangerede resultat.
ids string Kommaseparerede numeriske Bitculator-coin-id'er.
convert string Fiat-valutasymbol, som priserne konverteres til, f.eks. EUR. Standard er USD.
Værktøj

get_top_movers

De største vindere eller tabere målt på procentvis ændring over de seneste 24 timer eller 7 dage.

Parameter Type Beskrivelse
direction påkrævet enum gainers eller losers.
interval enum Ændringsvindue at rangere efter: 24h eller 7d (standard 24h).
limit integer Maksimalt antal coins at returnere (1–50, standard 10).

Historik

Værktøj

get_price_history

OHLCV-candlesticks for en coin over et datointerval. Opbevaring: minutely ~8 dage, half-hourly ~3 måneder, hourly ~6 måneder, daily = fuld historik. Returnerer de nyeste candlesticks i vinduet, ældste først.

Parameter Type Beskrivelse
slug påkrævet string Kanonisk coin-slug.
interval enum Candlestick-interval: minutely, half-hourly, hourly eller daily (standard daily).
start date Vinduets start som YYYY-MM-DD; standard er et nyligt vindue, der passer til intervallet.
end date Vinduets slutning som YYYY-MM-DD; standard er nu.
limit integer Maksimalt antal candlesticks at returnere (1–500, standard 90).
Værktøj

get_historical_price

Prisen på én coin på én bestemt dato i fortiden, med op til 3 dages fallback, når den præcise dag ikke har data.

Parameter Type Beskrivelse
slug påkrævet string Kanonisk coin-slug.
date påkrævet date Datoen som YYYY-MM-DD (2009-01-01 eller senere, ikke i fremtiden).
Værktøj

get_global_history

Tidsserie over den samlede kryptomarkedsværdi eller det samlede volumen. Granulariteten følger perioden: 24h er pr. halve time, 7d pr. time, 30d og all pr. dag.

Parameter Type Beskrivelse
metric påkrævet enum Hvilken serie der returneres: marketcap eller volume.
period enum Vindue: 24h, 7d, 30d eller all (standard 24h).

Sentiment & globalt

Værktøj

get_global_market

Øjebliksbillede af hele markedet: samlet markedsværdi, samlet 24-timers volumen, BTC/ETH-dominans og antal coins/tokens/børser/par.

Dette værktøj tager ingen parametre.

Værktøj

get_fear_greed

Fear & Greed-sentimentindekset for hele markedet, eller for én coin når der sendes en slug med, inklusive delscorer for 7d/30d-intervallerne.

Parameter Type Beskrivelse
coin string Valgfri coin-slug for en aflæsning pr. coin; udelad for det markedsdækkende indeks.
Værktøj

get_altseason_index

Altseason-indekset - om altcoins klarer sig bedre end Bitcoin - med valgfri daglig historik.

Parameter Type Beskrivelse
days integer Antal dage daglig historik at inkludere (0–365; 0 returnerer kun den aktuelle aflæsning).
Værktøj

get_liquidations_summary

Dagens samlede futures-likvidationer med long/short-fordelingen og dominans. Data kan være null lige efter døgnskiftet.

Dette værktøj tager ingen parametre.

Børser

Værktøj

list_exchanges

Rangerede børser med 24-timers volumen, volumendominans og antal par/aktiver. Oversætter også børsnavne til slugs.

Parameter Type Beskrivelse
type enum Begræns til centraliserede (cex) eller decentraliserede (dex) børser.
search string Fritekstsøgning matchet mod børsnavne.
sort string Kommaseparerede sorteringsfelter, "-"-præfiks for faldende: volume, rank, volume_dominance, change_24h, change_7d, pairs, assets.
limit integer Maksimalt antal børser at returnere (1–50, standard 10).
Værktøj

get_exchange

Fuld profil for én børs: rang, volumen og ændringer, dominans, listede par og aktiver samt links.

Parameter Type Beskrivelse
slug påkrævet string Kanonisk børs-slug, f.eks. binance-exchange.
Værktøj

get_exchange_trust_score

En børs' trust-score (0–10) med den fulde opdeling i 13 faktorer.

Parameter Type Beskrivelse
slug påkrævet string Kanonisk børs-slug.
Værktøj

get_coin_markets

Hvor en coin handles: dens markeder på tværs af børser med par, pris og 24-timers volumen, sorteret efter volumen.

Parameter Type Beskrivelse
slug påkrævet string Kanonisk coin-slug.
exchange string Valgfri børs-slug til at begrænse resultaterne til én handelsplads.
instrument enum Begræns til én instrumenttype: spot, future, option, swap eller margin.
limit integer Maksimalt antal markeder at returnere (1–50, standard 10).

Analyse & hjælpeværktøjer

Værktøj

get_coin_technicals

Det tekniske multi-indikator-øjebliksbillede for en coin i ét kald: RSI, MACD, SMA, ADX, MFI, CCI, OBV, VWAP, volatilitet og mere, hver med sin seneste tilstand og score.

Parameter Type Beskrivelse
slug påkrævet string Kanonisk coin-slug.
Værktøj

convert_currency

Konvertér et beløb mellem vilkårlige krypto- og/eller fiat-valutaer (op til 10 mål pr. kald) med live-kurser og fuld decimalpræcision.

Parameter Type Beskrivelse
from påkrævet string Kildevalutaens slug, f.eks. bitcoin eller united-states-dollar.
to påkrævet string Kommaseparerede målvaluta-slugs, op til 10.
amount number Beløb af kildevalutaen at konvertere (standard 1).
Værktøj

calculate_dca

Backtest en dollar-cost-averaging-strategi mod virkelig prishistorik: samlet investeret, akkumulerede coins, aktuel værdi og gevinst/tab.

Parameter Type Beskrivelse
slug påkrævet string Kanonisk coin-slug.
amount påkrævet number USD-beløb købt ved hvert interval.
interval påkrævet enum Købskadence: daily, weekly, monthly, quarterly eller yearly.
start påkrævet date Første købsdato som YYYY-MM-DD (før i dag).
end date Sidste købsdato som YYYY-MM-DD; standard er i dag.
series boolean Inkludér serien pr. køb (stort output - behold false, medmindre der bedes om det).