Bitculator
Bitculator MCP Server

Kryptodata i sanntid for AI-assistenten din

Bitculators MCP-server eksponerer Data API-et som 19 kuraterte, skrivebeskyttede verktøy over den åpne Model Context Protocol. Koble til én gang, og assistenten din svarer med sanntidspriser, historikk, sentiment og børsinnsikt.

Endepunkt
https://bitculator.com/mcp
Transport
Streamable HTTP
Autentisering
Bearer API-nøkkel
Verktøy
19 · skrivebeskyttede

MCP (Model Context Protocol) er den åpne standarden AI-klienter bruker for å nå eksterne verktøy. Enhver klient som støtter fjernservere over Streamable HTTP kan bruke Bitculator - avsnittene nedenfor dekker de mest populære. Alle priser, kurser, markedsverdier og tilbud returneres som decimal strings for å bevare presisjonen, akkurat som i REST API-et.

Autentisering

Serveren autentiserer med de samme nøklene som Data API-et: opprett en nøkkel med data-api-tillatelsen i utviklerkonsollen (gratisplanen fungerer - ikke noe kort kreves) og send den som en Bearer-header på hver forespørsel. Embed-nøkler avvises.

HTTP-header
Authorization: Bearer YOUR_API_KEY

Forespørsler uten en gyldig nøkkel får 401 unauthenticated. Nøkler er hemmeligheter - konfigurer dem i klientens innstillinger eller en miljøvariabel, aldri i delte filer du committer.

Claude Code

Én kommando registrerer serveren for prosjektet ditt (eller legg til --scope user for å gjøre den tilgjengelig overalt). Claude velger riktig verktøy automatisk når du spør om markedet.

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

Cursor

Legg serveren til i ~/.cursor/mcp.json (globalt) eller .cursor/mcp.json i et prosjekt. Verktøyene dukker opp i Cursors agent så snart filen er lagret.

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

VS Code

Legg serveren til i .vscode/mcp.json i arbeidsområdet ditt. GitHub Copilots agentmodus lister Bitculator-verktøyene automatisk.

.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-kall - send Bitculator-nøkkelen din 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 kobler til eksterne MCP-servere gjennom developer mode:

  1. Aktiver developer mode i ChatGPT-innstillingene (Apps & Connectors → Advanced).
  2. Legg til en connector med server-URL-en https://bitculator.com/mcp.
  3. ChatGPTs connector-autentisering er OAuth-basert - API-nøkkel-headere støttes ikke der ennå, så bruk en klient som kan kjøre uten autentisering, eller Claude-flatene for nøkkelbasert tilgang.

En OAuth-flyt (og med den full støtte for ChatGPT- og Claude-katalogene) står på veikartet. Nøkkelbaserte klienter - Claude Code, Cursor, VS Code, Claude API-et - fungerer i dag.

Kvote og grenser

MCP er en forbruksflate for Data API-et - det finnes ingen egen MCP-regning eller -pott.

  • Hvert verktøykall teller som én Data API-forespørsel mot planens månedlige kvote.
  • Planens burst-grense per minutt gjelder per verktøykall (Free 30, Starter 60, Pro 120).
  • Over kvoten returnerer verktøyene en rate_limited-feil som forteller assistenten når potten nullstilles. Plansperrede endepunkter returnerer plan_required.
  • Protokollhåndtrykket (initialize, tools/list) er gratis - bare verktøykall trekker fra potten.

Agent-rammeverk

Bygger du din egen agent? Alle store rammeverk leverer en MCP-klient som kobler til via Streamable HTTP med en Bearer-header - snuttene nedenfor laster alle 19 verktøy som native funksjoner.

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)

Verktøyreferanse

Alle 19 verktøyene er skrivebeskyttede. Parametrene speiler de tilsvarende Data API-endepunktene - samme validering, samme plansperrer, samme desimalstreng-presisjon.

Markedsdata

Verktøy

search_coins

Slå opp en mynt eller token ut fra fritekstnavn eller symbol og få den kanoniske sluggen, med et rangert markedssammendrag per treff. Inngangsporten: alle andre myntverktøy adresseres via slug.

Parameter Type Beskrivelse
query påkrevd string Fritekstsøk matchet mot myntnavn og symboler.
type enum Begrens treffene: coin eller token.
limit integer Maksimalt antall treff å returnere (1–50, standard 10).
Verktøy

get_coin

Full profil for én mynt: tilbud, rangering og rangeringsendringer, all-time high/low og avstanden fra dem, fullt utvannet verdsettelse, lenker, kontrakter og beskrivelse.

Parameter Type Beskrivelse
slug påkrevd string Kanonisk mynt-slug, f.eks. bitcoin.
Verktøy

get_prices

Gjeldende spotpriser for opptil 100 mynter i ett kall, valgfritt konvertert til en fiat-valuta. Den billigste måten å besvare prisspørsmål på - nøyaktig én selector kreves.

Parameter Type Beskrivelse
slugs string Kommaseparerte mynt-slugs - den foretrukne selectoren.
symbols string Kommaseparerte ticker-symboler; tvetydige symboler matches til det høyest rangerte treffet.
ids string Kommaseparerte numeriske Bitculator-mynt-id-er.
convert string Fiat-valutasymbol prisene skal konverteres til, f.eks. EUR. Standard er USD.
Verktøy

get_top_movers

De største vinnerne eller taperne målt i prosentvis endring de siste 24 timene eller 7 dagene.

Parameter Type Beskrivelse
direction påkrevd enum gainers eller losers.
interval enum Endringsvindu å rangere etter: 24h eller 7d (standard 24h).
limit integer Maksimalt antall mynter å returnere (1–50, standard 10).

Historikk

Verktøy

get_price_history

OHLCV-candlesticks for en mynt over et datointervall. Lagring: minutely ~8 dager, half-hourly ~3 måneder, hourly ~6 måneder, daily = full historikk. Returnerer de nyeste candlestickene i vinduet, eldst først.

Parameter Type Beskrivelse
slug påkrevd string Kanonisk mynt-slug.
interval enum Candlestick-intervall: minutely, half-hourly, hourly eller daily (standard daily).
start date Vinduets start som YYYY-MM-DD; standard er et nylig vindu tilpasset intervallet.
end date Vinduets slutt som YYYY-MM-DD; standard er nå.
limit integer Maksimalt antall candlesticks å returnere (1–500, standard 90).
Verktøy

get_historical_price

Prisen på én mynt på én bestemt dato i fortiden, med opptil 3 dagers fallback når den eksakte dagen mangler data.

Parameter Type Beskrivelse
slug påkrevd string Kanonisk mynt-slug.
date påkrevd date Datoen som YYYY-MM-DD (2009-01-01 eller senere, ikke i fremtiden).
Verktøy

get_global_history

Tidsserie over total kryptomarkedsverdi eller totalt volum. Granulariteten følger perioden: 24h er halvtimesvis, 7d timesvis, 30d og all daglig.

Parameter Type Beskrivelse
metric påkrevd enum Hvilken serie som returneres: marketcap eller volume.
period enum Vindu: 24h, 7d, 30d eller all (standard 24h).

Sentiment & globalt

Verktøy

get_global_market

Øyeblikksbilde av hele markedet: total markedsverdi, totalt 24-timers volum, BTC/ETH-dominans og antall mynter/tokens/børser/par.

Dette verktøyet tar ingen parametere.

Verktøy

get_fear_greed

Fear & Greed-sentimentindeksen for hele markedet, eller for én mynt når en slug sendes med, inkludert delscorer for 7d/30d-intervallene.

Parameter Type Beskrivelse
coin string Valgfri mynt-slug for en avlesning per mynt; utelat for den markedsdekkende indeksen.
Verktøy

get_altseason_index

Altseason-indeksen - om altcoins gjør det bedre enn Bitcoin - med valgfri daglig historikk.

Parameter Type Beskrivelse
days integer Antall dager med daglig historikk å inkludere (0–365; 0 returnerer bare gjeldende avlesning).
Verktøy

get_liquidations_summary

Dagens totale futures-likvidasjoner med long/short-fordelingen og dominans. Data kan være null rett etter døgnskiftet.

Dette verktøyet tar ingen parametere.

Børser

Verktøy

list_exchanges

Rangerte børser med 24-timers volum, volumdominans og antall par/aktiva. Oversetter også børsnavn til slugs.

Parameter Type Beskrivelse
type enum Begrens til sentraliserte (cex) eller desentraliserte (dex) børser.
search string Fritekstsøk matchet mot børsnavn.
sort string Kommaseparerte sorteringsfelter, "-"-prefiks for synkende: volume, rank, volume_dominance, change_24h, change_7d, pairs, assets.
limit integer Maksimalt antall børser å returnere (1–50, standard 10).
Verktøy

get_exchange

Full profil for én børs: rangering, volum og endringer, dominans, listede par og aktiva, samt lenker.

Parameter Type Beskrivelse
slug påkrevd string Kanonisk børs-slug, f.eks. binance-exchange.
Verktøy

get_exchange_trust_score

En børs' trust score (0–10) med full nedbryting i 13 faktorer.

Parameter Type Beskrivelse
slug påkrevd string Kanonisk børs-slug.
Verktøy

get_coin_markets

Hvor en mynt handles: markedene dens på tvers av børser med par, pris og 24-timers volum, sortert etter volum.

Parameter Type Beskrivelse
slug påkrevd string Kanonisk mynt-slug.
exchange string Valgfri børs-slug for å begrense resultatene til én handelsplass.
instrument enum Begrens til én instrumenttype: spot, future, option, swap eller margin.
limit integer Maksimalt antall markeder å returnere (1–50, standard 10).

Analyse & nytteverktøy

Verktøy

get_coin_technicals

Det tekniske multiindikator-øyeblikksbildet for en mynt i ett kall: RSI, MACD, SMA, ADX, MFI, CCI, OBV, VWAP, volatilitet og mer, hver med sin siste tilstand og score.

Parameter Type Beskrivelse
slug påkrevd string Kanonisk mynt-slug.
Verktøy

convert_currency

Konverter et beløp mellom hvilke som helst krypto- og/eller fiat-valutaer (opptil 10 mål per kall) med sanntidskurser og full desimalpresisjon.

Parameter Type Beskrivelse
from påkrevd string Kildevalutaens slug, f.eks. bitcoin eller united-states-dollar.
to påkrevd string Kommaseparerte målvaluta-slugs, opptil 10.
amount number Beløp av kildevalutaen som skal konverteres (standard 1).
Verktøy

calculate_dca

Backtest en dollar-cost-averaging-strategi mot ekte prishistorikk: totalt investert, akkumulerte mynter, nåværende verdi og gevinst/tap.

Parameter Type Beskrivelse
slug påkrevd string Kanonisk mynt-slug.
amount påkrevd number USD-beløp kjøpt ved hvert intervall.
interval påkrevd enum Kjøpskadens: daily, weekly, monthly, quarterly eller yearly.
start påkrevd date Første kjøpsdato som YYYY-MM-DD (før i dag).
end date Siste kjøpsdato som YYYY-MM-DD; standard er i dag.
series boolean Inkluder serien per kjøp (stort output - hold den på false med mindre det etterspørres).