Bitculator
Server MCP Bitculator

Živé krypto dáta pre vášho AI asistenta

Server MCP Bitculator sprístupňuje kryptotrh ako 19 starostlivo vybraných nástrojov len na čítanie cez otvorený Model Context Protocol. Pripojte sa raz a váš asistent vám bude odpovedať živými cenami, históriou, sentimentom a poznatkami o burzách.

Koncový bod
https://bitculator.com/mcp
Prenos
Streamable HTTP
Autentifikácia
Kľúč MCP typu Bearer
Nástroje
19 · len na čítanie

MCP (Model Context Protocol) je otvorený štandard, cez ktorý AI klienti pristupujú k externým nástrojom. Bitculator môže použiť ktorýkoľvek klient, ktorý podporuje vzdialené servery cez Streamable HTTP – sekcie nižšie pokrývajú tie najpoužívanejšie. MCP je samostatný produkt: fakturuje sa na vlastnom pláne, s vlastnými kľúčmi a vlastným mesačným prídelom volaní nástrojov. Všetky ceny, kurzy a ponuky sa vracajú ako desatinné reťazce, aby sa zachovala presnosť, presne ako v REST API. Trhové kapitalizácie a objemy sú bežné čísla JSON.

Autentifikácia

Autentifikácia na serveri prebieha kľúčmi MCP: v konzole MCP vytvorte kľúč s oprávnením mcp (stačí bezplatný plán MCP – karta nie je potrebná) a posielajte ho ako hlavičku Bearer pri každej požiadavke. Kľúče Data API a widgetov sú odmietnuté s chybou 401 unauthenticated.

Hlavička HTTP
Authorization: Bearer YOUR_API_KEY

Ak si klient alebo brána, napríklad Smithery, vyhradzuje hlavičku Authorization na vlastné prihlasovanie, môže ten istý kľúč namiesto toho posielať v hlavičke X-API-Key: YOUR_API_KEY.

Požiadavky bez platného kľúča dostanú 401 unauthenticated. Kľúče sú tajné údaje – nastavte ich v nastaveniach klienta alebo v premennej prostredia, nikdy nie v zdieľaných súboroch, ktoré commitujete.

Claude Code

Jeden príkaz zaregistruje server pre váš projekt (alebo pridajte --scope user, aby bol dostupný všade). Claude vyberie správny nástroj automaticky, keď sa spýtate na trh.

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

Cursor

Pridajte server do ~/.cursor/mcp.json (globálne) alebo do .cursor/mcp.json v projekte. Nástroje sa v agentovi Cursor objavia hneď po uložení súboru.

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

VS Code

Pridajte server do .vscode/mcp.json vo svojom pracovnom priestore. Agentový režim GitHub Copilota vypíše nástroje Bitculator automaticky.

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

Claude API

Vyvíjate vlastnú aplikáciu na Anthropic API? Konektor MCP sa k serveru dostane priamo z volania Messages API – svoj kľúč MCP Bitculator odovzdajte ako 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 sa k vzdialeným serverom MCP pripája cez vývojársky režim:

  1. V nastaveniach ChatGPT zapnite vývojársky režim (Apps & Connectors → Advanced).
  2. Pridajte konektor s URL servera https://bitculator.com/mcp.
  3. Autentifikácia konektorov v ChatGPT je založená na OAuth – hlavičky s API kľúčom tam zatiaľ nie sú podporované, preto na prístup pomocou kľúča použite klienta, ktorý zvláda pripojenie bez autentifikácie, alebo rozhrania Claude.

Prihlasovanie cez OAuth (a s ním plná podpora katalógov ChatGPT + Claude) je v pláne. Klienti s kľúčom – Claude Code, Cursor, VS Code, Claude API – fungujú už dnes.

Kvóta a limity

MCP je samostatný produkt s vlastným plánom, vlastným mesačným prídelom a vlastnými slotmi na kľúče – nikdy nečerpá z vašej kvóty Data API ani widgetov.

  • Každé volanie nástroja spotrebuje jedno volanie z mesačného prídelu vášho plánu MCP (Free 2 500, Starter 50 000, Pro 250 000).
  • Minútový nárazový limit vášho plánu MCP (Free 30, Starter 60, Pro 120) platí pre celý koncový bod, nielen pre volania nástrojov – initialize, notifications/initialized, tools/list, resources/*, prompts/* aj ping zaberajú po jednom slote. Volanie nástroja stále stojí presne jedno: interná požiadavka na Data API, ktorú odošle, je zo svojho vlastného nárazového limitu vyňatá.
  • Po vyčerpaní prídelu vracajú nástroje chybu rate_limited, ktorá asistentovi oznámi, kedy sa obdobie resetuje. Nástroje nad rámec vašej úrovne vracajú plan_required.
  • Volania handshaku a zisťovania nečerpajú nič z vášho mesačného prídelu – robia to iba volania nástrojov – spotrebúvajú však nárazové sloty. Odmietnutie pre nárazový limit je HTTP 429 na samotnej požiadavke JSON-RPC, takže váš klient ohlási chybu prenosu, nie chybu nástroja.

Agentové frameworky

Vyvíjate vlastného agenta? Každý väčší framework obsahuje klienta MCP, ktorý sa pripojí cez Streamable HTTP s kľúčom MCP typu Bearer – ukážky nižšie načítajú všetkých 19 nástrojov ako natívne funkcie.

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)

Prehľad nástrojov

Všetkých 19 nástrojov je len na čítanie. Parametre zodpovedajú príslušným koncovým bodom Data API – rovnaká validácia, rovnaká presnosť desatinných reťazcov – no prístup k jednotlivým nástrojom sa riadi vaším plánom MCP.

Trhové dáta

Nástroj

search_coins

Nájde kryptomenu alebo token podľa voľného textu v názve či symbole a priradí mu kanonický slug, pričom pri každej zhode uvedie trhový súhrn a zhody zoradí podľa poradia. Vstupný bod: každý ďalší nástroj pre kryptomeny sa adresuje slugom.

Parameter Typ Popis
query povinné string Voľnotextové vyhľadávanie porovnávané s názvami a symbolmi kryptomien.
type enum Obmedzí zhody: coin alebo token.
limit integer Maximálny počet vrátených zhôd (1–50, predvolene 10).
Nástroj

get_coin

Úplný profil jednej kryptomeny: ponuky, poradie a jeho zmeny, historické maximum/minimum a vzdialenosť od nich, plne zriedená valuácia, odkazy, kontrakty a popis.

Parameter Typ Popis
slug povinné string Kanonický slug kryptomeny, napr. bitcoin.
Nástroj

get_prices

Aktuálne spotové ceny až pre 100 kryptomien v jednom volaní, voliteľne prevedené do fiat meny. Najlacnejší spôsob, ako odpovedať na otázky o cenách – vyžaduje sa presne jeden selektor.

Parameter Typ Popis
slugs string Slugy kryptomien oddelené čiarkou – preferovaný selektor.
symbols string Symboly tickerov oddelené čiarkou; nejednoznačné symboly sa priradia k najvyššie zaradenej zhode.
ids string Číselné id kryptomien Bitculator oddelené čiarkou.
convert string Symbol fiat meny, do ktorej sa majú ceny previesť, napr. EUR. Predvolene USD.
Nástroj

get_top_movers

Kryptomeny s najväčším rastom alebo poklesom podľa percentuálnej zmeny za posledných 24 hodín alebo 7 dní.

Parameter Typ Popis
direction povinné enum gainers alebo losers.
interval enum Okno zmeny, podľa ktorého sa zoraďuje: 24h alebo 7d (predvolene 24h).
limit integer Maximálny počet vrátených kryptomien (1–50, predvolene 10).

História

Nástroj

get_price_history

Sviečky OHLCV pre kryptomenu za dátumový rozsah. Uchovávanie: minútové ~8 dní, polhodinové ~3 mesiace, hodinové ~6 mesiacov, denné = celá história. Vracia najnovšie sviečky v okne, od najstaršej.

Parameter Typ Popis
slug povinné string Kanonický slug kryptomeny.
interval enum Interval sviečky: minutely, half-hourly, hourly alebo daily (predvolene daily).
start date Začiatok okna vo formáte YYYY-MM-DD; predvolene nedávne okno primerané intervalu.
end date Koniec okna vo formáte YYYY-MM-DD; predvolene teraz.
limit integer Maximálny počet vrátených sviečok (1–500, predvolene 90).
Nástroj

get_historical_price

Cena jednej kryptomeny v konkrétny minulý dátum, s náhradou až 3 dni dozadu, keď pre presný deň nie sú dáta.

Parameter Typ Popis
slug povinné string Kanonický slug kryptomeny.
date povinné date Dátum vo formáte YYYY-MM-DD (2009-01-01 alebo neskôr, nie v budúcnosti).
Nástroj

get_global_history

Časový rad celkovej trhovej kapitalizácie kryptomien alebo celkového objemu. Granularita sa riadi obdobím: 24h je polhodinová, 7d hodinová, 30d a all denná.

Parameter Typ Popis
metric povinné enum Ktorý rad sa má vrátiť: marketcap alebo volume.
period enum Okno: 24h, 7d, 30d alebo all (predvolene 24h).

Sentiment a globálne dáta

Nástroj

get_global_market

Snímka celého trhu: celková trhová kapitalizácia, celkový 24h objem, dominancia BTC/ETH a počty kryptomien/tokenov/búrz/párov. Obsahuje aj trhovú hodnotu Fear & Greed – uvádzajte jej index (0–100), nie surové score.

Tento nástroj neprijíma žiadne parametre.

Nástroj

get_fear_greed

Sentimentový index strachu a chamtivosti pre celý trh alebo pre jednu kryptomenu, keď sa odovzdá slug, vrátane čiastkových skóre za intervaly 7d/30d. Uvádzajte index (0–100, ako ho zobrazuje Bitculator), nie surové score (−100…+100).

Parameter Typ Popis
coin string Voliteľný slug kryptomeny pre hodnotu za jednu kryptomenu; vynechajte pre celotrhový index.
Nástroj

get_altseason_index

Index altseason – či altcoiny prekonávajú Bitcoin – s voliteľnou dennou históriou.

Parameter Typ Popis
days integer Počet dní dennej histórie, ktoré sa majú zahrnúť (0–365; 0 vráti iba aktuálnu hodnotu).
Nástroj

get_liquidations_summary

Dnešné celkové likvidácie futures s rozdelením Long/Short a dominanciou. Hneď po dennom resete môžu byť dáta null.

Tento nástroj neprijíma žiadne parametre.

Burzy

Nástroj

list_exchanges

Burzy zoradené podľa poradia s 24h objemom, dominanciou objemu a počtami párov/aktív. Zároveň prevádza názvy búrz na slugy.

Parameter Typ Popis
type enum Obmedzí na centralizované (cex) alebo decentralizované (dex) burzy.
search string Voľnotextové vyhľadávanie porovnávané s názvami búrz.
sort string Polia na zoradenie oddelené čiarkou, predpona „-“ pre zostupné poradie: volume, rank, volume_dominance, change_24h, change_7d, pairs, assets.
limit integer Maximálny počet vrátených búrz (1–50, predvolene 10).
Nástroj

get_exchange

Úplný profil jednej burzy: poradie, objem a jeho zmeny, dominancia, obchodované páry a aktíva, odkazy.

Parameter Typ Popis
slug povinné string Kanonický slug burzy, napr. binance-exchange.
Nástroj

get_exchange_trust_score

Skóre dôvery burzy (0–10) s úplným 13-faktorovým rozpisom. Nezaradená burza (zatiaľ bez aktívneho spotového objemu) vráti skóre aj rozpis ako null: nebola ohodnotená, čo nie je to isté ako nízke skóre.

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

get_coin_markets

Kde sa kryptomena obchoduje: jej trhy naprieč burzami s párom, cenou a 24h objemom, zoradené podľa objemu.

Parameter Typ Popis
slug povinné string Kanonický slug kryptomeny.
exchange string Voliteľný slug burzy na obmedzenie výsledkov na jedno obchodné miesto.
instrument enum Obmedzí na jeden typ inštrumentu: spot, future, option, swap alebo margin.
limit integer Maximálny počet vrátených trhov (1–50, predvolene 10).

Analýza a pomôcky

Nástroj

get_coin_technicals

Technická snímka kryptomeny s viacerými indikátormi v jednom volaní: RSI, MACD, SMA, ADX, MFI, CCI, OBV, VWAP, volatilita a ďalšie, každý s najnovším stavom a skóre.

Parameter Typ Popis
slug povinné string Kanonický slug kryptomeny.
Nástroj

convert_currency

Prevedie sumu medzi ľubovoľnými krypto a/alebo fiat menami (až 10 cieľov na volanie) podľa živých kurzov, s plnou desatinnou presnosťou.

Parameter Typ Popis
from povinné string Slug zdrojovej meny, napr. bitcoin alebo united-states-dollar.
to povinné string Slugy cieľových mien oddelené čiarkou, najviac 10.
amount number Množstvo zdrojovej meny na prevod (predvolene 1).
Nástroj

calculate_dca

Spätne otestuje stratégiu DCA voči reálnej cenovej histórii: celkovo investované, nazhromaždené množstvo kryptomeny, aktuálna hodnota a zisk/strata.

Parameter Typ Popis
slug povinné string Kanonický slug kryptomeny.
amount povinné number Suma v USD nakúpená v každom intervale.
interval povinné enum Frekvencia nákupov: daily, weekly, monthly, quarterly alebo yearly.
start povinné date Dátum prvého nákupu vo formáte YYYY-MM-DD (pred dneškom).
end date Dátum posledného nákupu vo formáte YYYY-MM-DD; predvolene dnes.
series boolean Zahrnie rad podľa jednotlivých nákupov (veľký výstup – ponechajte false, ak ho výslovne nepotrebujete).