Bitculator
Bitculator MCP server

Živá kryptodata pro vašeho AI asistenta

MCP server Bitculatoru zpřístupňuje Data API jako 19 pečlivě vybraných nástrojů pouze pro čtení přes otevřený Model Context Protocol. Připojte se jednou a váš asistent bude odpovídat živými cenami, historií, sentimentem a přehledem o burzách.

Endpoint
https://bitculator.com/mcp
Transport
Streamable HTTP
Autentizace
Bearer API klíč
Nástroje
19 · pouze pro čtení

MCP (Model Context Protocol) je otevřený standard, kterým AI klienti sahají po externích nástrojích. Bitculator může používat každý klient podporující vzdálené servery přes Streamable HTTP — sekce níže pokrývají ty nejrozšířenější. Všechny ceny, kurzy, tržní kapitalizace i nabídky se vracejí jako decimal strings, aby se zachovala přesnost, přesně jako u REST API.

Autentizace

Server se autentizuje stejnými klíči jako Data API: vytvořte si klíč se schopností data-api ve vývojářské konzoli (stačí bezplatný plán — karta není potřeba) a posílejte ho jako Bearer hlavičku s každým požadavkem. Embed klíče jsou odmítány.

HTTP hlavička
Authorization: Bearer YOUR_API_KEY

Požadavky bez platného klíče dostanou 401 unauthenticated. Klíče jsou tajemství — nastavte je v konfiguraci svého klienta nebo v proměnné prostředí, nikdy ve sdílených souborech, které commitujete.

Claude Code

Jeden příkaz zaregistruje server pro váš projekt (nebo přidejte --scope user, aby byl dostupný všude). Když se zeptáte na trh, Claude si správný nástroj vybere automaticky.

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

Cursor

Přidejte server do ~/.cursor/mcp.json (globálně) nebo do .cursor/mcp.json v projektu. Jakmile soubor uložíte, nástroje se objeví v agentovi Cursoru.

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

VS Code

Přidejte server do .vscode/mcp.json ve svém workspace. Agentní režim GitHub Copilotu nástroje Bitculatoru vypíše automaticky.

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

Claude API

Stavíte vlastní aplikaci nad Anthropic API? MCP konektor se na server napojí přímo z volání Messages API — svůj klíč Bitculatoru předejte jako 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 se ke vzdáleným MCP serverům připojuje přes developer režim:

  1. Zapněte developer režim v nastavení ChatGPT (Apps & Connectors → Advanced).
  2. Přidejte konektor s URL serveru https://bitculator.com/mcp.
  3. Autentizace konektorů v ChatGPT stojí na OAuth — hlavičky s API klíčem tam zatím podporované nejsou, takže pro přístup s klíčem použijte klienta zvládajícího připojení bez autentizace, nebo povrchy Claude.

OAuth flow (a s ním plná podpora adresářů ChatGPT + Claude) je v plánu. Klienti s klíčem — Claude Code, Cursor, VS Code, Claude API — fungují už dnes.

Kvóta & limity

MCP je konzumní povrch Data API — žádné zvláštní MCP vyúčtování ani balík.

  • Každé volání nástroje se počítá jako jeden požadavek Data API z měsíční kvóty vašeho plánu.
  • Minutový burst limit vašeho plánu platí na každé volání nástroje (Free 30, Starter 60, Pro 120).
  • Po vyčerpání kvóty vracejí nástroje chybu rate_limited, která asistentovi řekne, kdy se balík resetuje. Endpointy vázané na plán vracejí plan_required.
  • Protokolový handshake (initialize, tools/list) je zdarma — z balíku čerpají jen volání nástrojů.

Agentní frameworky

Stavíte vlastního agenta? Každý velký framework obsahuje MCP klienta, který se připojuje přes Streamable HTTP s hlavičkou Bearer - ukázky níže načtou všech 19 nástrojů jako nativní funkce.

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)

Reference nástrojů

Všech 19 nástrojů je pouze pro čtení. Parametry zrcadlí odpovídající endpointy Data API — stejná validace, stejné plánové brány, stejná přesnost desetinných řetězců.

Tržní data

Nástroj

search_coins

Převede coin nebo token z volně zadaného názvu či symbolu na jeho kanonický slug, s hodnoceným tržním souhrnem u každé shody. Vstupní bod: každý další coinový nástroj se adresuje slugem.

Parametr Typ Popis
query povinné string Volně zadaný text porovnávaný s názvy a symboly coinů.
type enum Omezí shody: coin nebo token.
limit integer Maximum vrácených shod (1–50, výchozí 10).
Nástroj

get_coin

Kompletní profil jednoho coinu: nabídky, pořadí a jeho změny, historické maximum/minimum a vzdálenost od nich, plně zředěná valuace, odkazy, kontrakty a popis.

Parametr Typ Popis
slug povinné string Kanonický slug coinu, např. bitcoin.
Nástroj

get_prices

Aktuální spotové ceny až 100 coinů v jednom volání, volitelně převedené do fiat měny. Nejlevnější způsob, jak odpovídat na cenové dotazy — vyžaduje se právě jeden selektor.

Parametr Typ Popis
slugs string Slugy coinů oddělené čárkami — preferovaný selektor.
symbols string Ticker symboly oddělené čárkami; nejednoznačné symboly se převedou na shodu s nejvyšším pořadím.
ids string Číselná Bitculator id coinů oddělená čárkami.
convert string Symbol fiat měny, do které se ceny převedou, např. EUR. Výchozí je USD.
Nástroj

get_top_movers

Největší gainery nebo losery podle procentní změny za posledních 24 hodin nebo 7 dní.

Parametr Typ Popis
direction povinné enum gainers nebo losers.
interval enum Okno změny pro řazení: 24h nebo 7d (výchozí 24h).
limit integer Maximum vrácených coinů (1–50, výchozí 10).

Historie

Nástroj

get_price_history

OHLCV svíčky coinu za rozsah dat. Retence: minutové ~8 dní, půlhodinové ~3 měsíce, hodinové ~6 měsíců, denní = celá historie. Vrací nejnovější svíčky v okně, nejstarší první.

Parametr Typ Popis
slug povinné string Kanonický slug coinu.
interval enum Interval svíček: minutely, half-hourly, hourly nebo daily (výchozí daily).
start date Začátek okna jako YYYY-MM-DD; výchozí je nedávné okno odpovídající intervalu.
end date Konec okna jako YYYY-MM-DD; výchozí je teď.
limit integer Maximum vrácených svíček (1–500, výchozí 90).
Nástroj

get_historical_price

Cena jednoho coinu k jednomu konkrétnímu datu v minulosti, s fallbackem až 3 dny, když přesný den nemá data.

Parametr Typ Popis
slug povinné string Kanonický slug coinu.
date povinné date Datum jako YYYY-MM-DD (2009-01-01 nebo později, ne v budoucnu).
Nástroj

get_global_history

Časová řada celkové krypto tržní kapitalizace nebo celkového objemu. Granularita sleduje období: 24h je půlhodinová, 7d hodinová, 30d a all denní.

Parametr Typ Popis
metric povinné enum Která řada se má vrátit: marketcap nebo volume.
period enum Okno: 24h, 7d, 30d nebo all (výchozí 24h).

Sentiment & globální data

Nástroj

get_global_market

Snímek celého trhu: celková tržní kapitalizace, celkový 24h objem, dominance BTC/ETH a počty coinů/tokenů/burz/párů.

Tento nástroj nepřijímá žádné parametry.

Nástroj

get_fear_greed

Sentimentový index strachu a chamtivosti pro celý trh, nebo pro jeden coin při předání slugu, včetně dílčích skóre za intervaly 7d/30d.

Parametr Typ Popis
coin string Volitelný slug coinu pro hodnotu za jeden coin; vynechte pro celotržní index.
Nástroj

get_altseason_index

Index altseason — zda altcoiny překonávají Bitcoin — s volitelnou denní historií.

Parametr Typ Popis
days integer Počet dní denní historie k zahrnutí (0–365; 0 vrátí jen aktuální hodnotu).
Nástroj

get_liquidations_summary

Dnešní součty likvidací futures s rozdělením long/short a dominancí. Hned po denním překlopení mohou být data null.

Tento nástroj nepřijímá žádné parametry.

Burzy

Nástroj

list_exchanges

Seřazené burzy s 24h objemem, objemovou dominancí a počty párů/aktiv. Také převádí názvy burz na slugy.

Parametr Typ Popis
type enum Omezí na centralizované (cex) nebo decentralizované (dex) burzy.
search string Volně zadaný text porovnávaný s názvy burz.
sort string Pole řazení oddělená čárkami, prefix "-" pro sestupné řazení: volume, rank, volume_dominance, change_24h, change_7d, pairs, assets.
limit integer Maximum vrácených burz (1–50, výchozí 10).
Nástroj

get_exchange

Kompletní profil jedné burzy: pořadí, objem a jeho změny, dominance, listované páry a aktiva a odkazy.

Parametr Typ Popis
slug povinné string Kanonický slug burzy, např. binance-exchange.
Nástroj

get_exchange_trust_score

Skóre důvěryhodnosti burzy (0–10) s kompletním rozpadem na 13 faktorů.

Parametr Typ Popis
slug povinné string Kanonický slug burzy.
Nástroj

get_coin_markets

Kde se coin obchoduje: jeho trhy napříč burzami s párem, cenou a 24h objemem, seřazené podle objemu.

Parametr Typ Popis
slug povinné string Kanonický slug coinu.
exchange string Volitelný slug burzy pro omezení výsledků na jedno tržiště.
instrument enum Omezí na jeden typ instrumentu: spot, future, option, swap nebo margin.
limit integer Maximum vrácených trhů (1–50, výchozí 10).

Analýza & utility

Nástroj

get_coin_technicals

Multi-indikátorový technický snímek coinu v jednom volání: RSI, MACD, SMA, ADX, MFI, CCI, OBV, VWAP, volatilita a další, každý s nejnovějším stavem a skóre.

Parametr Typ Popis
slug povinné string Kanonický slug coinu.
Nástroj

convert_currency

Převeďte částku mezi libovolnými krypto a/nebo fiat měnami (až 10 cílů na volání) podle živých kurzů, s plnou desetinnou přesností.

Parametr Typ Popis
from povinné string Slug zdrojové měny, např. bitcoin nebo united-states-dollar.
to povinné string Slugy cílových měn oddělené čárkami, až 10.
amount number Množství zdrojové měny k převodu (výchozí 1).
Nástroj

calculate_dca

Backtestujte strategii průměrování nákladů (DCA) proti reálné cenové historii: celkem investováno, nakumulované coiny, aktuální hodnota a zisk/ztráta.

Parametr Typ Popis
slug povinné string Kanonický slug coinu.
amount povinné number Částka v USD nakoupená v každém intervalu.
interval povinné enum Kadence nákupů: daily, weekly, monthly, quarterly nebo yearly.
start povinné date Datum prvního nákupu jako YYYY-MM-DD (před dneškem).
end date Datum posledního nákupu jako YYYY-MM-DD; výchozí je dnešek.
series boolean Zahrnout řadu po jednotlivých nákupech (velký výstup — nechte false, pokud není vyžádáno).