Bitculator
Bitculator MCP Server

Live kryptodata för din AI-assistent

Bitculators MCP-server exponerar kryptomarknaden 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 MCP-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. MCP är en egen produkt: den faktureras på sin egen plan, med egna nycklar och en egen månatlig kvot för verktygsanrop. 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 MCP-nycklar: skapa en nyckel med mcp-behörigheten i MCP-konsolen (den kostnadsfria MCP-planen fungerar - inget kort krävs) och skicka den som en Bearer-header på varje begäran. Data API- och widget-nycklar avvisas med 401 unauthenticated.

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 MCP-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 fristående produkt med en egen plan, en egen månatlig kvot och egna nyckelplatser - den drar aldrig från din Data API- eller widget-kvot.

  • Varje verktygsanrop förbrukar ett anrop ur din MCP-plans månatliga kvot (Free 2 500, Starter 50 000, Pro 250 000).
  • Din MCP-plans burst-gräns per minut (Free 30, Starter 60, Pro 120) gäller hela endpointen, inte bara verktygsanrop - initialize, notifications/initialized, tools/list, resources/*, prompts/* och ping tar var sin plats. Ett verktygsanrop kostar fortfarande exakt ett: den interna Data API-förfrågan som det skickar är undantagen från sin egen burst-gräns.
  • Över kvoten returnerar verktygen ett rate_limited-fel som talar om för assistenten när perioden återställs. Verktyg över din nivå returnerar plan_required.
  • Handskakningen och upptäcktsanropen drar ingenting från din månatliga kvot - det gör bara verktygsanrop - men de förbrukar burst-platser. Ett burst-avslag är en HTTP 429 på själva JSON-RPC-förfrågan, så din klient rapporterar ett transportfel snarare än ett verktygsfel.

Agentramverk

Bygger du din egen agent? Alla stora ramverk levererar en MCP-klient som ansluter via Streamable HTTP med en Bearer MCP-nyckel - 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 precision i decimalsträngar - men planlåset på varje verktyg kommer från din MCP-plan.

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