Bitculator
Bitculator MCP-szerver

Élő kriptoadatok az AI-asszisztensedhez

A Bitculator MCP-szerver 19 gondosan válogatott, csak olvasható eszközként teszi elérhetővé a kriptopiacot a nyílt Model Context Protocol felett. Egyszer kell csatlakoztatni, és az asszisztensed élő árakkal, előzményekkel, hangulati adatokkal és tőzsdei információkkal válaszol.

Végpont
https://bitculator.com/mcp
Átvitel
Streamable HTTP
Hitelesítés
Bearer MCP-kulcs
Eszközök
19 · csak olvasható

Az MCP (Model Context Protocol) az a nyílt standard, amelyen az AI-kliensek külső eszközöket érnek el. Minden olyan kliens használhatja a Bitculatort, amely támogatja a Streamable HTTP-n futó távoli szervereket – az alábbi szakaszok a legnépszerűbbeket mutatják be. Az MCP önálló termék: saját csomagon, saját kulcsokkal és saját havi eszközhívás-kerettel számláz. Az árak, az arányok és a kínálati adatok a pontosság megőrzése érdekében decimal strings (decimális sztring) formában érkeznek vissza, pontosan úgy, mint a REST API-nál. A piaci kapitalizáció és a forgalom egyszerű JSON-szám.

Hitelesítés

A szerver MCP-kulcsokkal hitelesít: hozz létre egy kulcsot mcp jogosultsággal az MCP-konzolban (az ingyenes MCP-csomag is megfelel – kártya nem kell), és küldd el minden kérésnél Bearer fejlécként. A Data API- és widgetkulcsokat a szerver 401 unauthenticated hibával utasítja el.

HTTP-fejléc
Authorization: Bearer YOUR_API_KEY

Azok a kliensek és átjárók (például a Smithery), amelyek a saját bejelentkezésükhöz foglalják le az Authorization fejlécet, ugyanazt a kulcsot helyette X-API-Key: YOUR_API_KEY fejlécként küldhetik el.

Az érvényes kulcs nélküli kérések 401 unauthenticated választ kapnak. A kulcsok titkok – a kliens beállításaiban vagy környezeti változóban tárold őket, soha ne verziókezelt, megosztott fájlokban.

Claude Code

Egyetlen paranccsal regisztrálhatod a szervert a projektedhez (vagy add hozzá a --scope user kapcsolót, hogy mindenhol elérhető legyen). Ha a piacról kérdezel, a Claude automatikusan a megfelelő eszközt választja.

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

Cursor

Vedd fel a szervert a ~/.cursor/mcp.json fájlba (globálisan) vagy egy projekt .cursor/mcp.json fájljába. A fájl mentése után az eszközök megjelennek a Cursor ügynökében.

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

VS Code

Vedd fel a szervert a munkaterületed .vscode/mcp.json fájljába. A GitHub Copilot ügynök módja automatikusan listázza a Bitculator eszközeit.

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

Claude API

Saját alkalmazást fejlesztesz az Anthropic API-ra? Az MCP-összekötő közvetlenül egy Messages API-hívásból éri el a szervert – a Bitculator MCP-kulcsodat authorization_token értékként add át.

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

A ChatGPT fejlesztői módon keresztül kapcsolódik távoli MCP-szerverekhez:

  1. Kapcsold be a fejlesztői módot a ChatGPT beállításaiban (Apps & Connectors → Advanced).
  2. Adj hozzá egy összekötőt a https://bitculator.com/mcp szerver-URL-lel.
  3. A ChatGPT összekötőinek hitelesítése OAuth-alapú – API-kulcsos fejléceket ott még nem támogat, ezért kulcsalapú eléréshez használj hitelesítés nélkül is működő klienst vagy a Claude felületeit.

Az OAuth-folyamat (és vele a teljes ChatGPT- és Claude-katalógustámogatás) szerepel az ütemtervben. A kulcsalapú kliensek – Claude Code, Cursor, VS Code, Claude API – már ma működnek.

Kvóta és korlátok

Az MCP önálló termék, saját csomaggal, saját havi kerettel és saját kulcshelyekkel – soha nem a Data API- vagy widgetkvótádat fogyasztja.

  • Minden eszközhívás egy hívást vesz el az MCP-csomagod havi keretéből (Free 2500, Starter 50 000, Pro 250 000).
  • Az MCP-csomagod percenkénti löketkorlátja (Free 30, Starter 60, Pro 120) a teljes végpontra érvényes, nem csak az eszközhívásokra – az initialize, a notifications/initialized, a tools/list, a resources/*, a prompts/* és a ping is egy-egy helyet foglal. Egy eszközhívás így is pontosan egybe kerül: a hozzá tartozó belső Data API-kérés mentesül a saját löketkorlátja alól.
  • A keret túllépése után az eszközök rate_limited hibát adnak vissza, amely megmondja az asszisztensnek, mikor áll vissza a periódus. A csomagod szintje felett lévő eszközök plan_required hibát adnak.
  • A kézfogás- és felderítéshívások semmit nem vonnak le a havi keretedből – csak az eszközhívások –, de a löketkorlát helyeit fogyasztják. A löketkorlát miatti elutasítás HTTP 429-es válasz magára a JSON-RPC-kérésre, ezért a kliensed nem eszközhibát, hanem átviteli hibát jelez.

Ügynök-keretrendszerek

Saját ügynököt fejlesztesz? Minden nagyobb keretrendszerhez jár MCP-kliens, amely Streamable HTTP-n, Bearer MCP-kulccsal kapcsolódik – az alábbi kódrészletek mind a 19 eszközt natív függvényként töltik be.

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)

Eszközreferencia

Mind a 19 eszköz csak olvasható. A paraméterek a megfelelő Data API-végpontokat tükrözik – ugyanaz a validáció, ugyanaz a decimális sztring pontosság –, de az egyes eszközök csomagkorlátja az MCP-csomagodból jön.

Piaci adatok

Eszköz

search_coins

Érme vagy token feloldása szabad szöveges név vagy szimbólum alapján a kanonikus slugjára, találatonként rangsorolt piaci összefoglalóval. Ez a belépési pont: az összes többi érme-eszközt slug alapján kell megcímezni.

Paraméter Típus Leírás
query kötelező string Szabad szöveges keresés érmenevekre és szimbólumokra.
type enum Találatok szűkítése: coin vagy token.
limit integer Visszaadott találatok maximuma (1–50, alapértelmezés 10).
Eszköz

get_coin

Egy érme teljes profilja: kínálati adatok, helyezés és helyezésváltozások, történelmi csúcs/mélypont és a tőlük mért távolság, teljesen felhígított értékelés, linkek, szerződések és leírás.

Paraméter Típus Leírás
slug kötelező string Kanonikus érme-slug, pl. bitcoin.
Eszköz

get_prices

Akár 100 érme aktuális spotára egyetlen hívásban, igény szerint fiatvalutára átszámítva. A legköltséghatékonyabb módja az árkérdések megválaszolásának – pontosan egy szelektor kötelező.

Paraméter Típus Leírás
slugs string Vesszővel elválasztott érme-slugok – ez az előnyben részesített szelektor.
symbols string Vesszővel elválasztott ticker szimbólumok; a többértelmű szimbólumok a legjobb helyezésű találatra oldódnak fel.
ids string Vesszővel elválasztott numerikus Bitculator érme-azonosítók.
convert string A fiatvaluta szimbóluma, amelyre az árak átszámítódnak, pl. EUR. Alapértelmezés: USD.
Eszköz

get_top_movers

A legnagyobb nyertesek vagy vesztesek százalékos változás alapján az elmúlt 24 órában vagy 7 napban.

Paraméter Típus Leírás
direction kötelező enum gainers vagy losers.
interval enum A rangsorolás alapjául szolgáló változási ablak: 24h vagy 7d (alapértelmezés 24h).
limit integer Visszaadott érmék maximuma (1–50, alapértelmezés 10).

Előzmények

Eszköz

get_price_history

Egy érme OHLCV-gyertyái adott dátumtartományban. Megőrzés: perces ~8 nap, félórás ~3 hónap, órás ~6 hónap, napi = teljes előzmény. Az ablakban lévő legfrissebb gyertyákat adja vissza, a legrégebbivel kezdve.

Paraméter Típus Leírás
slug kötelező string Kanonikus érme-slug.
interval enum Gyertyaintervallum: minutely, half-hourly, hourly vagy daily (alapértelmezés daily).
start date Az ablak kezdete YYYY-MM-DD formában; alapértelmezés szerint az intervallumhoz illő friss ablak.
end date Az ablak vége YYYY-MM-DD formában; alapértelmezés szerint a jelenlegi idő.
limit integer Visszaadott gyertyák maximuma (1–500, alapértelmezés 90).
Eszköz

get_historical_price

Egy érme árfolyama egy adott korábbi dátumon; ha az adott napra nincs adat, legfeljebb 3 napot lép vissza.

Paraméter Típus Leírás
slug kötelező string Kanonikus érme-slug.
date kötelező date A dátum YYYY-MM-DD formában (2009-01-01 vagy későbbi, nem lehet a jövőben).
Eszköz

get_global_history

A teljes kriptopiaci kapitalizáció vagy a teljes forgalom időbeli sora. A felbontás a periódushoz igazodik: 24h félórás, 7d órás, 30d és all napi.

Paraméter Típus Leírás
metric kötelező enum Melyik sort adja vissza: marketcap vagy volume.
period enum Ablak: 24h, 7d, 30d vagy all (alapértelmezés 24h).

Hangulat és globális adatok

Eszköz

get_global_market

Teljes piaci pillanatkép: összes piaci kapitalizáció, 24 órás összforgalom, BTC/ETH-dominancia, valamint érme-, token-, tőzsde- és párszámok. A piaci Fear & Greed értéket is tartalmazza – az index értéket (0–100) idézze, ne a nyers score értéket.

Ez az eszköz nem vesz át paramétert.

Eszköz

get_fear_greed

A félelem és kapzsiság hangulatindex a teljes piacra, vagy egy érmére, ha slugot adsz meg, a 7d/30d intervallumok részpontszámaival együtt. Az index értéket (0–100, ahogy a Bitculator mutatja) idézze, ne a nyers score értéket (−100…+100).

Paraméter Típus Leírás
coin string Opcionális érme-slug az érménkénti értékhez; hagyd el a piac egészére vonatkozó indexhez.
Eszköz

get_altseason_index

Az altszezon-index – azt mutatja, hogy az altcoinok felülteljesítik-e a Bitcoint –, opcionális napi előzménnyel.

Paraméter Típus Leírás
days integer A napi előzményből bevont napok száma (0–365; a 0 csak az aktuális értéket adja vissza).
Eszköz

get_liquidations_summary

A mai határidős likvidálások összesítése a long/short megosztással és a dominanciával. Közvetlenül a napi váltás után az adat null lehet.

Ez az eszköz nem vesz át paramétert.

Tőzsdék

Eszköz

list_exchanges

Rangsorolt tőzsdék 24 órás forgalommal, forgalmi dominanciával, valamint pár- és eszközszámokkal. Tőzsdenevek slugra való feloldására is használható.

Paraméter Típus Leírás
type enum Szűkítés centralizált (cex) vagy decentralizált (dex) tőzsdékre.
search string Szabad szöveges keresés tőzsdenevekre.
sort string Vesszővel elválasztott rendezési mezők, csökkenő sorrendhez „-” előtaggal: volume, rank, volume_dominance, change_24h, change_7d, pairs, assets.
limit integer Visszaadott tőzsdék maximuma (1–50, alapértelmezés 10).
Eszköz

get_exchange

Egy tőzsde teljes profilja: helyezés, forgalom és változások, dominancia, listázott párok és eszközök, valamint linkek.

Paraméter Típus Leírás
slug kötelező string Kanonikus tőzsde-slug, pl. binance-exchange.
Eszköz

get_exchange_trust_score

Egy tőzsde bizalmi pontszáma (0–10) a teljes, 13 tényezős lebontással. A rangsorban nem szereplő tőzsde (még nincs aktív spotforgalma) null pontszámot és lebontást ad vissza: nincs pontozva, ami nem ugyanaz, mint az alacsony pontszám.

Paraméter Típus Leírás
slug kötelező string Kanonikus tőzsde-slug.
Eszköz

get_coin_markets

Hol kereskednek egy érmével: a piacai a különböző tőzsdéken párral, árral és 24 órás forgalommal, forgalom szerint rendezve.

Paraméter Típus Leírás
slug kötelező string Kanonikus érme-slug.
exchange string Opcionális tőzsde-slug az eredmények egyetlen helyszínre szűkítéséhez.
instrument enum Szűkítés egy instrumentumtípusra: spot, future, option, swap vagy margin.
limit integer Visszaadott piacok maximuma (1–50, alapértelmezés 10).

Elemzés és segédeszközök

Eszköz

get_coin_technicals

Egy érme többindikátoros technikai pillanatképe egyetlen hívásban: RSI, MACD, SMA, ADX, MFI, CCI, OBV, VWAP, volatilitás és több más, mindegyik a legfrissebb állapotával és pontszámával.

Paraméter Típus Leírás
slug kötelező string Kanonikus érme-slug.
Eszköz

convert_currency

Összeg átszámítása bármely kripto- és/vagy fiatvaluta között (hívásonként legfeljebb 10 célvaluta) élő árfolyamokkal, teljes decimális pontossággal.

Paraméter Típus Leírás
from kötelező string A forrásvaluta slugja, pl. bitcoin vagy united-states-dollar.
to kötelező string Vesszővel elválasztott célvaluta-slugok, legfeljebb 10.
amount number Az átszámítandó forrásvaluta összege (alapértelmezés 1).
Eszköz

calculate_dca

Dollárköltség-átlagolási stratégia visszatesztelése valós árfolyam-előzményeken: összes befektetett összeg, felhalmozott érmék, jelenlegi érték és nyereség/veszteség.

Paraméter Típus Leírás
slug kötelező string Kanonikus érme-slug.
amount kötelező number Az egyes intervallumokban vásárolt USD-összeg.
interval kötelező enum Vásárlási ütem: daily, weekly, monthly, quarterly vagy yearly.
start kötelező date Az első vásárlás dátuma YYYY-MM-DD formában (a mai nap előtt).
end date Az utolsó vásárlás dátuma YYYY-MM-DD formában; alapértelmezés szerint a mai nap.
series boolean A vásárlásonkénti sor is szerepeljen (nagy kimenet – hagyd false értéken, ha nem kérik).