Bitculator
Bitculator MCP server

Živi kripto podaci za vašeg AI asistenta

Bitculator MCP server izlaže kripto tržište kroz 19 pažljivo odabranih alatki samo za čitanje preko otvorenog standarda Model Context Protocol. Povežite se jednom i vaš asistent odgovara uz žive cene, istoriju, sentiment i podatke o berzama.

Krajnja tačka
https://bitculator.com/mcp
Transport
Streamable HTTP
Autentifikacija
Bearer MCP ključ
Alatke
19 · samo za čitanje

MCP (Model Context Protocol) je otvoreni standard koji AI klijenti koriste da dođu do spoljnih alatki. Svaki klijent koji podržava udaljene servere preko Streamable HTTP transporta može da koristi Bitculator - odeljci ispod pokrivaju najpopularnije. MCP je samostalan proizvod: naplaćuje se po sopstvenom planu, sa sopstvenim ključevima i sopstvenom mesečnom kvotom poziva alatki. Sve cene, kursevi i ponude vraćaju se kao decimal strings radi očuvanja preciznosti, isto kao u REST API-ju. Tržišne kapitalizacije i prometi su obični JSON brojevi.

Autentifikacija

Server se autentifikuje MCP ključevima: kreirajte ključ sa dozvolom mcp u MCP konzoli (besplatan MCP plan je dovoljan - kartica nije potrebna) i pošaljite ga kao Bearer zaglavlje pri svakom zahtevu. Data API i vidžet ključevi se odbijaju sa 401 unauthenticated.

HTTP zaglavlje
Authorization: Bearer YOUR_API_KEY

Klijenti i mrežni prolazi koji rezervišu zaglavlje Authorization za sopstvenu prijavu, kao što je Smithery, mogu umesto toga da šalju isti ključ kao zaglavlje X-API-Key: YOUR_API_KEY.

Zahtevi bez ispravnog ključa dobijaju 401 unauthenticated. Ključevi su tajni podaci - podesite ih u postavkama klijenta ili u promenljivoj okruženja, nikada u deljenim datotekama koje šaljete u repozitorijum.

Claude Code

Jedna komanda registruje server za vaš projekat (ili dodajte --scope user da bude dostupan svuda). Claude automatski bira pravu alatku kada pitate o tržištu.

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

Cursor

Dodajte server u ~/.cursor/mcp.json (globalno) ili u .cursor/mcp.json unutar projekta. Alatke se pojavljuju u Cursor agentu kada se datoteka sačuva.

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

VS Code

Dodajte server u .vscode/mcp.json u vašem radnom prostoru. Agentski režim u GitHub Copilotu automatski prikazuje Bitculator alatke.

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

Claude API

Gradite sopstvenu aplikaciju na Anthropic API-ju? MCP konektor dolazi do servera direktno iz poziva Messages API-ja - pošaljite svoj Bitculator MCP ključ kao 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 povezuje na udaljene MCP servere kroz režim za programere:

  1. Uključite režim za programere u ChatGPT postavkama (Apps & Connectors → Advanced).
  2. Dodajte konektor sa URL adresom servera https://bitculator.com/mcp.
  3. Autentifikacija konektora u ChatGPT-u zasniva se na OAuth-u - zaglavlja sa API ključem tu još nisu podržana, pa za pristup putem ključa koristite klijent koji može bez autentifikacije ili Claude platforme.

OAuth tok (a sa njim i puna podrška za ChatGPT i Claude direktorijum) je na planu razvoja. Klijenti zasnovani na ključu - Claude Code, Cursor, VS Code, Claude API - rade već danas.

Kvota i ograničenja

MCP je samostalan proizvod sa sopstvenim planom, sopstvenom mesečnom kvotom i sopstvenim mestima za ključeve - nikada ne troši kvotu vašeg Data API-ja ili vidžeta.

  • Svaki poziv alatke troši jedan poziv iz mesečne kvote vašeg MCP plana (Free 2.500, Starter 50.000, Pro 250.000).
  • Minutni limit vašeg MCP plana (Free 30, Starter 60, Pro 120) primenjuje se na celu krajnju tačku, a ne samo na pozive alatki - initialize, notifications/initialized, tools/list, resources/*, prompts/* i ping zauzimaju po jedno mesto. Poziv alatke i dalje košta tačno jedan: interni zahtev ka Data API-ju koji on pokreće izuzet je od sopstvenog minutnog limita.
  • Kada se kvota potroši, alatke vraćaju grešku rate_limited koja asistentu govori kada se period obnavlja. Alatke iznad vašeg nivoa vraćaju plan_required.
  • Pozivi za uspostavljanje veze i otkrivanje ne troše ništa iz vaše mesečne kvote - to rade samo pozivi alatki - ali zauzimaju minutna mesta. Odbijanje zbog minutnog limita je HTTP 429 na samom JSON-RPC zahtevu, pa vaš klijent prijavljuje grešku transporta, a ne grešku alatke.

Agentski radni okviri

Gradite sopstvenog agenta? Svaki veći radni okvir ima MCP klijenta koji se povezuje preko Streamable HTTP transporta uz Bearer MCP ključ - primeri ispod učitavaju svih 19 alatki kao izvorne funkcije.

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)

Pregled alatki

Svih 19 alatki je samo za čitanje. Parametri odgovaraju istim krajnjim tačkama Data API-ja - ista validacija, ista preciznost decimalnih stringova - ali ograničenje po planu za svaku alatku dolazi iz vašeg MCP plana.

Tržišni podaci

Alatka

search_coins

Pronađite kovanicu ili token po slobodnom tekstu (naziv ili simbol) i dobijte kanonski slug, uz rangirani tržišni pregled za svako poklapanje. Ulazna tačka: svaka druga alatka za kovanice adresira se po slugu.

Parametar Tip Opis
query obavezno string Pretraga slobodnim tekstom koja se poklapa sa nazivima i simbolima kovanica.
type enum Ograničite poklapanja: coin ili token.
limit integer Najviše poklapanja koja se vraćaju (1–50, podrazumevano 10).
Alatka

get_coin

Kompletan profil jedne kovanice: ponude, rang i promene ranga, istorijski maksimum i minimum i udaljenost od njih, potpuno razvodnjena vrednost, linkovi, ugovori i opis.

Parametar Tip Opis
slug obavezno string Kanonski slug kovanice, npr. bitcoin.
Alatka

get_prices

Trenutne spot cene za do 100 kovanica u jednom pozivu, uz opcionu konverziju u fiat valutu. Najjeftiniji način da odgovorite na pitanja o ceni - obavezan je tačno jedan selektor.

Parametar Tip Opis
slugs string Slugovi kovanica razdvojeni zapetama - preporučeni selektor.
symbols string Simboli tikera razdvojeni zapetama; dvosmisleni simboli se razrešavaju u najbolje rangirano poklapanje.
ids string Numerički Bitculator id-jevi kovanica razdvojeni zapetama.
convert string Simbol fiat valute u koju se cene konvertuju, npr. EUR. Podrazumevano USD.
Alatka

get_top_movers

Najveći dobitnici ili gubitnici po procentualnoj promeni u poslednja 24 sata ili 7 dana.

Parametar Tip Opis
direction obavezno enum gainers ili losers.
interval enum Prozor promene po kojem se rangira: 24h ili 7d (podrazumevano 24h).
limit integer Najviše kovanica koje se vraćaju (1–50, podrazumevano 10).

Istorija

Alatka

get_price_history

OHLCV sveće za kovanicu u zadatom opsegu datuma. Zadržavanje: po minutu ~8 dana, na pola sata ~3 meseca, po satu ~6 meseci, dnevno = cela istorija. Vraća najnovije sveće u prozoru, najstarije prvo.

Parametar Tip Opis
slug obavezno string Kanonski slug kovanice.
interval enum Interval sveće: minutely, half-hourly, hourly ili daily (podrazumevano daily).
start date Početak prozora u formatu YYYY-MM-DD; podrazumevano nedavan prozor koji odgovara intervalu.
end date Kraj prozora u formatu YYYY-MM-DD; podrazumevano sadašnji trenutak.
limit integer Najviše sveća koje se vraćaju (1–500, podrazumevano 90).
Alatka

get_historical_price

Cena jedne kovanice na jedan određeni prošli datum, sa rezervnim opsegom do 3 dana kada za tačan dan nema podataka.

Parametar Tip Opis
slug obavezno string Kanonski slug kovanice.
date obavezno date Datum u formatu YYYY-MM-DD (2009-01-01 ili kasnije, ne u budućnosti).
Alatka

get_global_history

Vremenska serija ukupne tržišne kapitalizacije ili ukupnog prometa. Granularnost prati period: 24h je na pola sata, 7d po satu, 30d i all dnevno.

Parametar Tip Opis
metric obavezno enum Koja serija se vraća: marketcap ili volume.
period enum Prozor: 24h, 7d, 30d ili all (podrazumevano 24h).

Sentiment i globalni podaci

Alatka

get_global_market

Snimak celog tržišta: ukupna tržišna kapitalizacija, ukupan promet za 24h, dominacija BTC i ETH, i broj kovanica, tokena, berzi i parova. Sadrži i tržišno očitavanje Fear & Greed – navodite vrednost index (0–100), a ne sirovu vrednost score.

Ova alatka ne prima parametre.

Alatka

get_fear_greed

Indeks sentimenta strah i pohlepa za celo tržište, ili za jednu kovanicu kada se pošalje slug, uključujući podrezultate za intervale 7d i 30d. Navodite vrednost index (0–100, kako je prikazuje Bitculator), a ne sirovu vrednost score (−100…+100).

Parametar Tip Opis
coin string Opcioni slug kovanice za čitanje po kovanici; izostavite za indeks celog tržišta.
Alatka

get_altseason_index

Indeks altsezone - da li altkovanice nadmašuju Bitcoin - uz opcionu dnevnu istoriju.

Parametar Tip Opis
days integer Broj dana dnevne istorije koji se uključuje (0–365; 0 vraća samo trenutno čitanje).
Alatka

get_liquidations_summary

Današnji ukupni podaci o likvidacijama futures pozicija, sa podelom na long i short i dominacijom. Podaci mogu biti null odmah nakon dnevnog preloma.

Ova alatka ne prima parametre.

Berze

Alatka

list_exchanges

Rangirane berze sa prometom za 24h, dominacijom prometa i brojem parova i sredstava. Takođe prevodi nazive berzi u slugove.

Parametar Tip Opis
type enum Ograničite na centralizovane (cex) ili decentralizovane (dex) berze.
search string Pretraga slobodnim tekstom koja se poklapa sa nazivima berzi.
sort string Polja za sortiranje razdvojena zapetama, prefiks „-” za opadajući red: volume, rank, volume_dominance, change_24h, change_7d, pairs, assets.
limit integer Najviše berzi koje se vraćaju (1–50, podrazumevano 10).
Alatka

get_exchange

Kompletan profil jedne berze: rang, promet i promene, dominacija, izlistani parovi i sredstva, i linkovi.

Parametar Tip Opis
slug obavezno string Kanonski slug berze, npr. binance-exchange.
Alatka

get_exchange_trust_score

Ocena pouzdanosti berze (0–10) sa kompletnim prikazom svih 13 faktora. Nerangirana berza (još bez aktivnog spot prometa) vraća null ocenu i prazan prikaz: nije ocenjena, što nije isto što i niska ocena.

Parametar Tip Opis
slug obavezno string Kanonski slug berze.
Alatka

get_coin_markets

Gde se kovanica trguje: njena tržišta na berzama, sa parom, cenom i prometom za 24h, sortirano po prometu.

Parametar Tip Opis
slug obavezno string Kanonski slug kovanice.
exchange string Opcioni slug berze za ograničavanje rezultata na jedno mesto trgovanja.
instrument enum Ograničite na jedan tip instrumenta: spot, future, option, swap ili margin.
limit integer Najviše tržišta koja se vraćaju (1–50, podrazumevano 10).

Analiza i pomoćne alatke

Alatka

get_coin_technicals

Tehnički snimak sa više indikatora za kovanicu u jednom pozivu: RSI, MACD, SMA, ADX, MFI, CCI, OBV, VWAP, volatilnost i drugo, svaki sa najnovijim stanjem i ocenom.

Parametar Tip Opis
slug obavezno string Kanonski slug kovanice.
Alatka

convert_currency

Konvertujte iznos između bilo kojih kripto i fiat valuta (do 10 ciljnih valuta po pozivu) po živim kursevima, sa punom decimalnom preciznošću.

Parametar Tip Opis
from obavezno string Slug izvorne valute, npr. bitcoin ili united-states-dollar.
to obavezno string Slugovi ciljnih valuta razdvojeni zapetama, do 10.
amount number Iznos izvorne valute koji se konvertuje (podrazumevano 1).
Alatka

calculate_dca

Retroaktivno testirajte strategiju prosečne cene ulaganja (DCA) na stvarnoj istoriji cena: ukupno uloženo, prikupljene kovanice, trenutna vrednost i profit ili gubitak.

Parametar Tip Opis
slug obavezno string Kanonski slug kovanice.
amount obavezno number Iznos u USD kupljen u svakom intervalu.
interval obavezno enum Ritam kupovine: daily, weekly, monthly, quarterly ili yearly.
start obavezno date Datum prve kupovine u formatu YYYY-MM-DD (pre današnjeg dana).
end date Datum poslednje kupovine u formatu YYYY-MM-DD; podrazumevano danas.
series boolean Uključite seriju po kupovini (veliki izlaz - ostavite false osim ako se izričito traži).