Bitculator
Bitculator MCP Server

Live kryptodata til din AI-assistent

Bitculators MCP-server eksponerer kryptomarkedet 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 MCP-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. MCP er sit eget produkt: det afregnes på sin egen plan, med sine egne nøgler og sin egen månedlige kvote af værktøjskald. 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 MCP-nøgler: opret en nøgle med mcp-tilladelsen i MCP-konsollen (den gratis MCP-plan virker - intet kort påkrævet), og send den som en Bearer-header på hvert request. Data API- og widget-nøgler afvises med 401 unauthenticated.

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 MCP-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 et selvstændigt produkt med sin egen plan, sin egen månedlige kvote og sine egne nøglepladser - det trækker aldrig på din Data API- eller widget-kvote.

  • Hvert værktøjskald bruger ét kald af din MCP-plans månedlige kvote (Free 2.500, Starter 50.000, Pro 250.000).
  • Din MCP-plans burst pr. minut (Free 30, Starter 60, Pro 120) håndhæves på hele endpointet, ikke kun på værktøjskald - initialize, notifications/initialized, tools/list, resources/*, prompts/* og ping optager hver en plads. Et værktøjskald koster stadig præcis ét: den interne Data API-forespørgsel, det udløser, er undtaget fra sin egen burst.
  • Over kvoten returnerer værktøjerne en rate_limited-fejl, der fortæller assistenten, hvornår perioden nulstilles. Værktøjer over dit niveau returnerer plan_required.
  • Handshake- og discovery-kald trækker intet fra din månedlige kvote - det gør kun værktøjskald - men de bruger burst-pladser. En burst-afvisning er en HTTP 429 på selve JSON-RPC-forespørgslen, så din klient melder en transportfejl frem for en værktøjsfejl.

Agent-frameworks

Bygger du din egen agent? Alle store frameworks leverer en MCP-klient, der forbinder via Streamable HTTP med en Bearer MCP-nøgle - 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 decimalstreng-præcision - men plan-gaten på hvert værktøj kommer fra din MCP-plan.

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).