Bitculator
Bitculator MCP Server

Kryptodane na żywo dla Twojego asystenta AI

Serwer MCP Bitculator udostępnia Data API jako 19 wyselekcjonowanych narzędzi tylko do odczytu przez otwarty Model Context Protocol. Połącz się raz, a Twój asystent będzie odpowiadał cenami na żywo, historią, sentymentem i danymi o giełdach.

Endpoint
https://bitculator.com/mcp
Transport
Streamable HTTP
Uwierzytelnianie
Klucz API Bearer
Narzędzia
19 · tylko do odczytu

MCP (Model Context Protocol) to otwarty standard, którego klienci AI używają, by sięgać po zewnętrzne narzędzia. Każdy klient obsługujący zdalne serwery przez Streamable HTTP może korzystać z Bitculator — sekcje poniżej opisują te najpopularniejsze. Wszystkie ceny, kursy, kapitalizacje i podaże są zwracane jako decimal strings, aby zachować precyzję — dokładnie tak jak w REST API.

Uwierzytelnianie

Serwer uwierzytelnia się tymi samymi kluczami co Data API: utwórz klucz z uprawnieniem data-api w konsoli deweloperskiej (plan darmowy wystarczy — karta nie jest wymagana) i wysyłaj go jako nagłówek Bearer w każdym żądaniu. Klucze embed są odrzucane.

Nagłówek HTTP
Authorization: Bearer YOUR_API_KEY

Żądania bez ważnego klucza otrzymują 401 unauthenticated. Klucze to sekrety — konfiguruj je w ustawieniach klienta lub zmiennej środowiskowej, nigdy we współdzielonych plikach, które commitujesz.

Claude Code

Jedno polecenie rejestruje serwer dla Twojego projektu (lub dodaj --scope user, aby był dostępny wszędzie). Claude sam wybiera właściwe narzędzie, gdy pytasz o rynek.

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

Cursor

Dodaj serwer do ~/.cursor/mcp.json (globalnie) lub do .cursor/mcp.json w projekcie. Narzędzia pojawią się w agencie Cursor zaraz po zapisaniu pliku.

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

VS Code

Dodaj serwer do .vscode/mcp.json w swoim workspace. Tryb agenta GitHub Copilot automatycznie wyświetli narzędzia Bitculator.

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

Claude API

Budujesz własną aplikację na Anthropic API? Konektor MCP sięga do serwera bezpośrednio z wywołania Messages API — przekaż swój klucz Bitculator 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 łączy się ze zdalnymi serwerami MCP przez tryb dewelopera:

  1. Włącz tryb dewelopera w ustawieniach ChatGPT (Apps & Connectors → Advanced).
  2. Dodaj konektor z URL-em serwera https://bitculator.com/mcp.
  3. Uwierzytelnianie konektorów ChatGPT opiera się na OAuth — nagłówki z kluczem API nie są tam jeszcze obsługiwane, więc do dostępu opartego na kluczu użyj klienta działającego bez autoryzacji lub powierzchni Claude.

Przepływ OAuth (a wraz z nim pełne wsparcie katalogów ChatGPT i Claude) jest w mapie drogowej. Klienci oparci na kluczu — Claude Code, Cursor, VS Code, Claude API — działają już dziś.

Limit i ograniczenia

MCP to powierzchnia konsumpcji Data API — nie ma osobnego rachunku ani puli dla MCP.

  • Każde wywołanie narzędzia liczy się jako jedno żądanie Data API względem miesięcznego limitu Twojego planu.
  • Minutowy limit Twojego planu obowiązuje dla każdego wywołania narzędzia (Free 30, Starter 60, Pro 120).
  • Po przekroczeniu limitu narzędzia zwracają błąd rate_limited, który informuje asystenta, kiedy pula się zresetuje. Endpointy zamknięte planem zwracają plan_required.
  • Uścisk dłoni protokołu (initialize, tools/list) jest darmowy — z puli czerpią tylko wywołania narzędzi.

Frameworki agentowe

Budujesz własnego agenta? Każdy duży framework zawiera klienta MCP łączącego się przez Streamable HTTP z nagłówkiem Bearer - poniższe fragmenty ładują wszystkie 19 narzędzi jak natywne funkcje.

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)

Dokumentacja narzędzi

Wszystkie 19 narzędzi jest tylko do odczytu. Parametry odzwierciedlają odpowiadające im endpointy Data API — ta sama walidacja, te same bramki planów, ta sama precyzja łańcuchów dziesiętnych.

Dane rynkowe

Narzędzie

search_coins

Dopasowuje monetę lub token po dowolnej tekstowej nazwie albo symbolu do jej kanonicznego sluga, z rankingowanym podsumowaniem rynkowym dla każdego trafienia. Punkt wejścia: każde inne narzędzie monetowe adresuje się slugiem.

Parametr Typ Opis
query wymagany string Dowolne wyszukiwanie tekstowe dopasowywane do nazw i symboli monet.
type enum Ogranicz dopasowania: coin lub token.
limit integer Maksymalna liczba trafień do zwrócenia (1–50, domyślnie 10).
Narzędzie

get_coin

Pełny profil jednej monety: podaże, ranking i jego zmiany, historyczne maksimum/minimum i odległość od nich, w pełni rozwodniona wycena, linki, kontrakty i opis.

Parametr Typ Opis
slug wymagany string Kanoniczny slug monety, np. bitcoin.
Narzędzie

get_prices

Bieżące ceny spot dla maks. 100 monet w jednym wywołaniu, opcjonalnie przeliczone na walutę fiat. Najtańszy sposób odpowiadania na pytania o cenę — wymagany jest dokładnie jeden selektor.

Parametr Typ Opis
slugs string Slugi monet rozdzielone przecinkami — preferowany selektor.
symbols string Symbole tickerów rozdzielone przecinkami; niejednoznaczne symbole dopasowywane są do monety o najwyższym rankingu.
ids string Numeryczne id monet Bitculator rozdzielone przecinkami.
convert string Symbol waluty fiat, na którą przeliczyć ceny, np. EUR. Domyślnie USD.
Narzędzie

get_top_movers

Najwięksi zyskujący lub tracący według zmiany procentowej z ostatnich 24 godzin lub 7 dni.

Parametr Typ Opis
direction wymagany enum gainers lub losers.
interval enum Okno zmiany do rankingu: 24h lub 7d (domyślnie 24h).
limit integer Maksymalna liczba monet do zwrócenia (1–50, domyślnie 10).

Historia

Narzędzie

get_price_history

Świece OHLCV dla monety w zakresie dat. Retencja: minutowe ~8 dni, półgodzinne ~3 miesiące, godzinowe ~6 miesięcy, dzienne = pełna historia. Zwraca najnowsze świece w oknie, od najstarszych.

Parametr Typ Opis
slug wymagany string Kanoniczny slug monety.
interval enum Interwał świecy: minutely, half-hourly, hourly lub daily (domyślnie daily).
start date Początek okna jako YYYY-MM-DD; domyślnie niedawne okno dopasowane do interwału.
end date Koniec okna jako YYYY-MM-DD; domyślnie teraz.
limit integer Maksymalna liczba świec do zwrócenia (1–500, domyślnie 90).
Narzędzie

get_historical_price

Cena jednej monety w jednym konkretnym dniu w przeszłości, z fallbackiem do 3 dni, gdy dokładny dzień nie ma danych.

Parametr Typ Opis
slug wymagany string Kanoniczny slug monety.
date wymagany date Data jako YYYY-MM-DD (2009-01-01 lub później, nie w przyszłości).
Narzędzie

get_global_history

Szereg czasowy łącznej kapitalizacji kryptorynku lub łącznego wolumenu. Granulacja zależy od okresu: 24h jest półgodzinna, 7d godzinowa, 30d i all dzienna.

Parametr Typ Opis
metric wymagany enum Który szereg zwrócić: marketcap lub volume.
period enum Okno: 24h, 7d, 30d lub all (domyślnie 24h).

Sentyment i dane globalne

Narzędzie

get_global_market

Migawka całego rynku: łączna kapitalizacja, łączny wolumen 24h, dominacja BTC/ETH oraz liczby monet/tokenów/giełd/par.

To narzędzie nie przyjmuje parametrów.

Narzędzie

get_fear_greed

Indeks sentymentu strachu i chciwości dla całego rynku lub dla jednej monety, gdy podany jest slug, wraz z pod-ocenami dla interwałów 7d/30d.

Parametr Typ Opis
coin string Opcjonalny slug monety dla odczytu per moneta; pomiń dla indeksu całego rynku.
Narzędzie

get_altseason_index

Indeks altseason — czy altcoiny radzą sobie lepiej niż Bitcoin — z opcjonalną dzienną historią.

Parametr Typ Opis
days integer Liczba dni dziennej historii do uwzględnienia (0–365; 0 zwraca tylko bieżący odczyt).
Narzędzie

get_liquidations_summary

Dzisiejsze sumy likwidacji futures z podziałem long/short i dominacją. Zaraz po dziennym rolowaniu dane mogą być null.

To narzędzie nie przyjmuje parametrów.

Giełdy

Narzędzie

list_exchanges

Rankingowane giełdy z wolumenem 24h, dominacją wolumenu oraz liczbą par/aktywów. Dopasowuje też nazwy giełd do slugów.

Parametr Typ Opis
type enum Ogranicz do giełd scentralizowanych (cex) lub zdecentralizowanych (dex).
search string Dowolne wyszukiwanie tekstowe dopasowywane do nazw giełd.
sort string Pola sortowania rozdzielone przecinkami, prefiks "-" dla malejąco: volume, rank, volume_dominance, change_24h, change_7d, pairs, assets.
limit integer Maksymalna liczba giełd do zwrócenia (1–50, domyślnie 10).
Narzędzie

get_exchange

Pełny profil jednej giełdy: ranking, wolumen i zmiany, dominacja, notowane pary i aktywa oraz linki.

Parametr Typ Opis
slug wymagany string Kanoniczny slug giełdy, np. binance-exchange.
Narzędzie

get_exchange_trust_score

Wskaźnik zaufania giełdy (0–10) z pełnym rozbiciem na 13 czynników.

Parametr Typ Opis
slug wymagany string Kanoniczny slug giełdy.
Narzędzie

get_coin_markets

Gdzie handluje się monetą: jej rynki na giełdach z parą, ceną i wolumenem 24h, posortowane według wolumenu.

Parametr Typ Opis
slug wymagany string Kanoniczny slug monety.
exchange string Opcjonalny slug giełdy, aby ograniczyć wyniki do jednego miejsca handlu.
instrument enum Ogranicz do jednego typu instrumentu: spot, future, option, swap lub margin.
limit integer Maksymalna liczba rynków do zwrócenia (1–50, domyślnie 10).

Analiza i narzędzia pomocnicze

Narzędzie

get_coin_technicals

Wielowskaźnikowa migawka techniczna monety w jednym wywołaniu: RSI, MACD, SMA, ADX, MFI, CCI, OBV, VWAP, zmienność i więcej — każdy z najnowszym stanem i oceną.

Parametr Typ Opis
slug wymagany string Kanoniczny slug monety.
Narzędzie

convert_currency

Konwertuje kwotę między dowolnymi walutami krypto i/lub fiat (maks. 10 celów na wywołanie) po kursach na żywo, z pełną precyzją dziesiętną.

Parametr Typ Opis
from wymagany string Slug waluty źródłowej, np. bitcoin lub united-states-dollar.
to wymagany string Slugi walut docelowych rozdzielone przecinkami, maks. 10.
amount number Kwota waluty źródłowej do przeliczenia (domyślnie 1).
Narzędzie

calculate_dca

Backtest strategii uśredniania kosztu zakupu (DCA) na prawdziwej historii cen: łącznie zainwestowano, zgromadzone monety, bieżąca wartość oraz zysk/strata.

Parametr Typ Opis
slug wymagany string Kanoniczny slug monety.
amount wymagany number Kwota w USD kupowana w każdym interwale.
interval wymagany enum Częstotliwość zakupów: daily, weekly, monthly, quarterly lub yearly.
start wymagany date Data pierwszego zakupu jako YYYY-MM-DD (przed dniem dzisiejszym).
end date Data ostatniego zakupu jako YYYY-MM-DD; domyślnie dziś.
series boolean Dołącz serię per zakup (duży wynik — zostaw false, chyba że poproszono).