Bitculator
Bitculator MCP Server

Live kryptodata för din AI-assistent

Bitculators MCP-server exponerar Data API som 19 utvalda, skrivskyddade verktyg över det öppna Model Context Protocol. Anslut en gång, så svarar din assistent med livepriser, historik, sentiment och börsinsikter.

Endpoint
https://bitculator.com/mcp
Transport
Streamable HTTP
Autentisering
Bearer API-nyckel
Verktyg
19 · skrivskyddade

MCP (Model Context Protocol) är den öppna standard AI-klienter använder för att nå externa verktyg. Alla klienter som stöder fjärrservrar över Streamable HTTP kan använda Bitculator - avsnitten nedan täcker de mest populära. Alla priser, kurser, marknadsvärden och tillgångar returneras som decimal strings för att bevara precisionen, precis som i REST-API:t.

Autentisering

Servern autentiserar med samma nycklar som Data API: skapa en nyckel med data-api-behörigheten i utvecklarkonsolen (gratisplanen fungerar - inget kort krävs) och skicka den som en Bearer-header på varje begäran. Embed-nycklar avvisas.

HTTP-header
Authorization: Bearer YOUR_API_KEY

Begäranden utan giltig nyckel får 401 unauthenticated. Nycklar är hemligheter - konfigurera dem i klientens inställningar eller i en miljövariabel, aldrig i delade filer som du committar.

Claude Code

Ett kommando registrerar servern för ditt projekt (eller lägg till --scope user för att göra den tillgänglig överallt). Claude väljer rätt verktyg automatiskt när du frågar om marknaden.

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

Cursor

Lägg till servern i ~/.cursor/mcp.json (globalt) eller .cursor/mcp.json i ett projekt. Verktygen dyker upp i Cursors agent så snart filen är sparad.

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

VS Code

Lägg till servern i .vscode/mcp.json i din workspace. GitHub Copilots agentläge listar Bitculator-verktygen automatiskt.

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

Claude API

Bygger du en egen app på Anthropic-API:t? MCP-connectorn når servern direkt från ett Messages API-anrop - skicka din Bitculator-nyckel 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 ansluter till externa MCP-servrar via developer mode:

  1. Aktivera developer mode i ChatGPT:s inställningar (Apps & Connectors → Advanced).
  2. Lägg till en connector med server-URL:en https://bitculator.com/mcp.
  3. ChatGPT:s connector-autentisering är OAuth-baserad - API-nyckel-headers stöds inte där ännu, så använd en klient som klarar sig utan autentisering, eller Claude-ytorna för nyckelbaserad åtkomst.

Ett OAuth-flöde (och därmed fullt stöd för ChatGPT- och Claude-katalogerna) finns på vår roadmap. Nyckelbaserade klienter - Claude Code, Cursor, VS Code, Claude API - fungerar i dag.

Kvot & gränser

MCP är en konsumtionsyta för Data API - det finns ingen separat MCP-faktura eller -pott.

  • Varje verktygsanrop räknas som en Data API-begäran mot din plans månatliga kvot.
  • Din plans burst-gräns per minut gäller per verktygsanrop (Free 30, Starter 60, Pro 120).
  • Över kvoten returnerar verktygen ett rate_limited-fel som talar om för assistenten när potten återställs. Planlåsta endpoints returnerar plan_required.
  • Protokollhandskakningen (initialize, tools/list) är gratis - endast verktygsanrop dras från potten.

Agentramverk

Bygger du din egen agent? Alla stora ramverk levererar en MCP-klient som ansluter via Streamable HTTP med en Bearer-header - kodexemplen nedan laddar alla 19 verktyg som inbyggda 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)

Verktygsreferens

Alla 19 verktyg är skrivskyddade. Parametrarna speglar motsvarande Data API-endpoints - samma validering, samma planlås, samma precision i decimalsträngar.

Marknadsdata

Verktyg

search_coins

Slå upp ett coin eller en token via fritextnamn eller symbol och få dess kanoniska slug, med en rankad marknadssammanfattning per träff. Ingången: alla andra coin-verktyg adresseras via slug.

Parameter Typ Beskrivning
query obligatorisk string Fritextsökning som matchas mot coin-namn och symboler.
type enum Begränsa träffarna: coin eller token.
limit integer Maximalt antal träffar att returnera (1–50, standard 10).
Verktyg

get_coin

Fullständig profil för ett coin: tillgångar, rank och rankförändringar, all time high/low och avståndet dit, fullt utspädd värdering, länkar, kontrakt och beskrivning.

Parameter Typ Beskrivning
slug obligatorisk string Kanonisk coin-slug, t.ex. bitcoin.
Verktyg

get_prices

Aktuella spotpriser för upp till 100 coins i ett anrop, valfritt konverterade till en fiatvaluta. Det billigaste sättet att besvara prisfrågor - exakt en selector krävs.

Parameter Typ Beskrivning
slugs string Kommaseparerade coin-slugs - den rekommenderade selectorn.
symbols string Kommaseparerade ticker-symboler; tvetydiga symboler matchas till den högst rankade träffen.
ids string Kommaseparerade numeriska Bitculator-coin-id:n.
convert string Fiatvalutasymbol att konvertera priserna till, t.ex. EUR. Standard är USD.
Verktyg

get_top_movers

De största vinnarna eller förlorarna efter procentuell förändring de senaste 24 timmarna eller 7 dagarna.

Parameter Typ Beskrivning
direction obligatorisk enum gainers eller losers.
interval enum Förändringsfönster att ranka efter: 24h eller 7d (standard 24h).
limit integer Maximalt antal coins att returnera (1–50, standard 10).

Historik

Verktyg

get_price_history

OHLCV-candlesticks för ett coin över ett datumintervall. Lagring: minutely ~8 dagar, half-hourly ~3 månader, hourly ~6 månader, daily = full historik. Returnerar de senaste candlesticksen i fönstret, äldst först.

Parameter Typ Beskrivning
slug obligatorisk string Kanonisk coin-slug.
interval enum Candlestick-intervall: minutely, half-hourly, hourly eller daily (standard daily).
start date Fönstrets start som YYYY-MM-DD; standard är ett nyligt fönster anpassat till intervallet.
end date Fönstrets slut som YYYY-MM-DD; standard är nu.
limit integer Maximalt antal candlesticks att returnera (1–500, standard 90).
Verktyg

get_historical_price

Priset för ett coin på ett specifikt datum bakåt i tiden, med upp till 3 dagars fallback när den exakta dagen saknar data.

Parameter Typ Beskrivning
slug obligatorisk string Kanonisk coin-slug.
date obligatorisk date Datumet som YYYY-MM-DD (2009-01-01 eller senare, inte i framtiden).
Verktyg

get_global_history

Tidsserie över det totala kryptomarknadsvärdet eller den totala volymen. Granulariteten följer perioden: 24h är per halvtimme, 7d per timme, 30d och all per dag.

Parameter Typ Beskrivning
metric obligatorisk enum Vilken serie som returneras: marketcap eller volume.
period enum Fönster: 24h, 7d, 30d eller all (standard 24h).

Sentiment & globalt

Verktyg

get_global_market

Ögonblicksbild av hela marknaden: totalt marknadsvärde, total 24-timmarsvolym, BTC/ETH-dominans samt antal coins/tokens/börser/par.

Det här verktyget tar inga parametrar.

Verktyg

get_fear_greed

Fear & Greed-sentimentindexet för hela marknaden, eller för ett coin när en slug anges, inklusive delpoäng för 7d/30d-intervallen.

Parameter Typ Beskrivning
coin string Valfri coin-slug för en avläsning per coin; utelämna för det marknadsövergripande indexet.
Verktyg

get_altseason_index

Altseason-indexet - om altcoins presterar bättre än Bitcoin - med valfri daglig historik.

Parameter Typ Beskrivning
days integer Antal dagar av daglig historik att inkludera (0–365; 0 returnerar endast den aktuella avläsningen).
Verktyg

get_liquidations_summary

Dagens totala futures-likvidationer med long/short-fördelningen och dominans. Data kan vara null direkt efter dygnsskiftet.

Det här verktyget tar inga parametrar.

Börser

Verktyg

list_exchanges

Rankade börser med 24-timmarsvolym, volymdominans och antal par/tillgångar. Matchar också börsnamn till slugs.

Parameter Typ Beskrivning
type enum Begränsa till centraliserade (cex) eller decentraliserade (dex) börser.
search string Fritextsökning som matchas mot börsnamn.
sort string Kommaseparerade sorteringsfält, "-"-prefix för fallande: volume, rank, volume_dominance, change_24h, change_7d, pairs, assets.
limit integer Maximalt antal börser att returnera (1–50, standard 10).
Verktyg

get_exchange

Fullständig profil för en börs: rank, volym och förändringar, dominans, listade par och tillgångar samt länkar.

Parameter Typ Beskrivning
slug obligatorisk string Kanonisk börs-slug, t.ex. binance-exchange.
Verktyg

get_exchange_trust_score

En börs trust score (0–10) med hela nedbrytningen i 13 faktorer.

Parameter Typ Beskrivning
slug obligatorisk string Kanonisk börs-slug.
Verktyg

get_coin_markets

Var ett coin handlas: dess marknader över börser med par, pris och 24-timmarsvolym, sorterade efter volym.

Parameter Typ Beskrivning
slug obligatorisk string Kanonisk coin-slug.
exchange string Valfri börs-slug för att begränsa resultaten till en handelsplats.
instrument enum Begränsa till en instrumenttyp: spot, future, option, swap eller margin.
limit integer Maximalt antal marknader att returnera (1–50, standard 10).

Analys & hjälpverktyg

Verktyg

get_coin_technicals

Den tekniska multiindikator-ögonblicksbilden för ett coin i ett anrop: RSI, MACD, SMA, ADX, MFI, CCI, OBV, VWAP, volatilitet med mera, var och en med sitt senaste läge och sin poäng.

Parameter Typ Beskrivning
slug obligatorisk string Kanonisk coin-slug.
Verktyg

convert_currency

Konvertera ett belopp mellan valfria krypto- och/eller fiatvalutor (upp till 10 mål per anrop) med livekurser och full decimalprecision.

Parameter Typ Beskrivning
from obligatorisk string Källvalutans slug, t.ex. bitcoin eller united-states-dollar.
to obligatorisk string Kommaseparerade målvaluta-slugs, upp till 10.
amount number Belopp av källvalutan att konvertera (standard 1).
Verktyg

calculate_dca

Backtesta en dollar-cost averaging-strategi mot verklig prishistorik: totalt investerat, ackumulerade coins, nuvarande värde och vinst/förlust.

Parameter Typ Beskrivning
slug obligatorisk string Kanonisk coin-slug.
amount obligatorisk number USD-belopp som köps vid varje intervall.
interval obligatorisk enum Köpfrekvens: daily, weekly, monthly, quarterly eller yearly.
start obligatorisk date Första köpdatum som YYYY-MM-DD (före i dag).
end date Sista köpdatum som YYYY-MM-DD; standard är i dag.
series boolean Inkludera serien per köp (stor utdata - låt den vara false om det inte efterfrågas).