Bitculator
Server MCP Bitculator

Date cripto în timp real pentru asistentul dumneavoastră AI

Serverul MCP Bitculator expune piața cripto prin 19 instrumente selectate, doar pentru citire, peste protocolul deschis Model Context Protocol. Conectați-vă o singură dată, iar asistentul dumneavoastră răspunde cu prețuri în timp real, istoric, sentiment și informații despre burse.

Endpoint
https://bitculator.com/mcp
Transport
Streamable HTTP
Autentificare
Cheie MCP Bearer
Instrumente
19 · doar pentru citire

MCP (Model Context Protocol) este standardul deschis prin care clienții AI ajung la instrumente externe. Orice client care acceptă servere la distanță peste Streamable HTTP poate folosi Bitculator - secțiunile de mai jos acoperă clienții cei mai răspândiți. MCP este un produs în sine: se facturează pe propriul abonament, cu chei proprii și cu propria alocație lunară de apeluri de instrumente. Toate prețurile, cursurile și ofertele sunt returnate ca șiruri de caractere zecimale pentru a păstra precizia, exact ca în API-ul REST. Capitalizările de piață și volumele sunt numere JSON simple.

Autentificare

Serverul se autentifică cu chei MCP: creați o cheie cu permisiunea mcp în Consola MCP (abonamentul MCP gratuit funcționează - nu este nevoie de card) și trimiteți-o ca antet Bearer la fiecare cerere. Cheile pentru API-ul de date și pentru widget-uri sunt respinse cu 401 unauthenticated.

Antet HTTP
Authorization: Bearer YOUR_API_KEY

Clienții și gateway-urile care rezervă antetul Authorization pentru propria autentificare, cum ar fi Smithery, pot trimite în schimb aceeași cheie ca antet X-API-Key: YOUR_API_KEY.

Cererile fără o cheie valabilă primesc 401 unauthenticated. Cheile sunt secrete - configurați-le în setările clientului sau într-o variabilă de mediu, niciodată în fișiere partajate pe care le comiteți.

Claude Code

O singură comandă înregistrează serverul pentru proiectul dumneavoastră (sau adăugați --scope user pentru a-l face disponibil peste tot). Claude alege automat instrumentul potrivit atunci când întrebați despre piață.

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

Cursor

Adăugați serverul în ~/.cursor/mcp.json (global) sau în .cursor/mcp.json dintr-un proiect. Instrumentele apar în agentul Cursor imediat după salvarea fișierului.

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

VS Code

Adăugați serverul în .vscode/mcp.json din spațiul dumneavoastră de lucru. Modul agent din GitHub Copilot listează automat instrumentele Bitculator.

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

Claude API

Construiți propria aplicație pe API-ul Anthropic? Conectorul MCP ajunge direct la server dintr-un apel Messages API - transmiteți cheia dumneavoastră MCP Bitculator ca 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 conectează la servere MCP la distanță prin modul pentru dezvoltatori:

  1. Activați modul pentru dezvoltatori în setările ChatGPT (Apps & Connectors → Advanced).
  2. Adăugați un conector cu adresa serverului https://bitculator.com/mcp.
  3. Autentificarea conectorilor din ChatGPT se bazează pe OAuth - anteturile cu chei de API nu sunt încă acceptate acolo, așa că folosiți un client care poate lucra fără autentificare sau interfețele Claude pentru acces pe bază de cheie.

Un flux OAuth (și, odată cu el, suport complet pentru directoarele ChatGPT + Claude) se află pe foaia de parcurs. Clienții pe bază de cheie - Claude Code, Cursor, VS Code, API-ul Claude - funcționează deja astăzi.

Cotă și limite

MCP este un produs de sine stătător, cu propriul abonament, propria alocație lunară și propriile sloturi de chei - nu consumă niciodată din cota pentru API-ul de date sau pentru widget-uri.

  • Fiecare apel de instrument consumă un apel din alocația lunară a abonamentului MCP (Gratuit 2.500, Starter 50.000, Pro 250.000).
  • Limita pe minut a abonamentului MCP (Gratuit 30, Starter 60, Pro 120) se aplică întregului endpoint, nu doar apelurilor de instrumente - initialize, notifications/initialized, tools/list, resources/*, prompts/* și ping ocupă fiecare câte un slot. Un apel de instrument costă tot exact unul: cererea internă către API-ul de date pe care o declanșează este scutită de propria limită pe minut.
  • Peste alocație, instrumentele returnează o eroare rate_limited care îi spune asistentului când se resetează perioada. Instrumentele de peste treapta dumneavoastră returnează plan_required.
  • Apelurile de handshake și de descoperire nu consumă nimic din alocația lunară - doar apelurile de instrumente o fac - dar ocupă sloturi din limita pe minut. O respingere din limita pe minut este un HTTP 429 chiar pe cererea JSON-RPC, așa că clientul dumneavoastră raportează o eroare de transport, nu o eroare de instrument.

Frameworkuri pentru agenți

Construiți propriul agent? Fiecare framework important include un client MCP care se conectează peste Streamable HTTP cu o cheie MCP Bearer - fragmentele de cod de mai jos încarcă toate cele 19 instrumente ca funcții native.

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)

Referința instrumentelor

Toate cele 19 instrumente sunt doar pentru citire. Parametrii reflectă endpointurile corespunzătoare din API-ul de date - aceeași validare, aceeași precizie cu șiruri zecimale - dar restricția de abonament a fiecărui instrument vine din abonamentul dumneavoastră MCP.

Date de piață

Instrument

search_coins

Identifică o monedă sau un token după nume ori simbol în text liber și returnează slugul canonic, cu un sumar de piață clasat pentru fiecare potrivire. Punctul de intrare: orice alt instrument pentru monede este adresat prin slug.

Parametru Tip Descriere
query obligatoriu string Căutare în text liber, comparată cu numele și simbolurile monedelor.
type enum Restrânge potrivirile: coin sau token.
limit integer Numărul maxim de potriviri returnate (1–50, implicit 10).
Instrument

get_coin

Profil complet pentru o monedă: ofertele, rangul și variațiile de rang, maximul/minimul istoric și distanța până la ele, evaluarea complet diluată, linkuri, contracte și descriere.

Parametru Tip Descriere
slug obligatoriu string Slug canonic de monedă, de ex. bitcoin.
Instrument

get_prices

Prețurile spot actuale pentru până la 100 de monede într-un singur apel, opțional convertite într-o monedă fiat. Cea mai ieftină cale de a răspunde la întrebări despre preț - este obligatoriu exact un selector.

Parametru Tip Descriere
slugs string Sluguri de monede separate prin virgulă - selectorul preferat.
symbols string Simboluri de ticker separate prin virgulă; simbolurile ambigue se rezolvă către potrivirea cu cel mai bun rang.
ids string ID-uri numerice Bitculator de monede, separate prin virgulă.
convert string Simbolul monedei fiat în care se convertesc prețurile, de ex. EUR. Implicit USD.
Instrument

get_top_movers

Cele mai mari creșteri sau scăderi după variația procentuală din ultimele 24 de ore sau 7 zile.

Parametru Tip Descriere
direction obligatoriu enum gainers sau losers.
interval enum Intervalul de variație după care se face clasarea: 24h sau 7d (implicit 24h).
limit integer Numărul maxim de monede returnate (1–50, implicit 10).

Istoric

Instrument

get_price_history

Lumânări OHLCV pentru o monedă pe un interval de date. Retenție: minutely ~8 zile, half-hourly ~3 luni, hourly ~6 luni, daily = istoric complet. Returnează cele mai recente lumânări din interval, începând cu cele mai vechi.

Parametru Tip Descriere
slug obligatoriu string Slug canonic de monedă.
interval enum Intervalul lumânărilor: minutely, half-hourly, hourly sau daily (implicit daily).
start date Începutul intervalului, în format YYYY-MM-DD; implicit, o perioadă recentă potrivită pentru intervalul ales.
end date Sfârșitul intervalului, în format YYYY-MM-DD; implicit, momentul actual.
limit integer Numărul maxim de lumânări returnate (1–500, implicit 90).
Instrument

get_historical_price

Prețul unei monede la o anumită dată din trecut, cu o rezervă de până la 3 zile atunci când ziua exactă nu are date.

Parametru Tip Descriere
slug obligatoriu string Slug canonic de monedă.
date obligatoriu date Data în format YYYY-MM-DD (2009-01-01 sau ulterioară, nu în viitor).
Instrument

get_global_history

Serie temporală a capitalizării totale de piață cripto sau a volumului total. Granularitatea urmează perioada: 24h este la jumătate de oră, 7d la oră, iar 30d și all zilnic.

Parametru Tip Descriere
metric obligatoriu enum Seria care se returnează: marketcap sau volume.
period enum Perioada: 24h, 7d, 30d sau all (implicit 24h).

Sentiment și date globale

Instrument

get_global_market

Instantaneu al întregii piețe: capitalizare totală de piață, volum total pe 24h, dominanța BTC/ETH și numărul de monede/tokenuri/burse/perechi. Include și citirea Fear & Greed a pieței – citați index (0–100), nu valoarea brută score.

Acest instrument nu primește parametri.

Instrument

get_fear_greed

Indicele de sentiment frică și lăcomie pentru întreaga piață sau pentru o singură monedă atunci când se transmite un slug, inclusiv subscorurile pe intervalele 7d/30d. Citați index (0–100, așa cum apare pe Bitculator), nu valoarea brută score (−100…+100).

Parametru Tip Descriere
coin string Slug opțional de monedă pentru o citire per monedă; omiteți-l pentru indicele la nivelul întregii piețe.
Instrument

get_altseason_index

Indicele Altseason - dacă altcoinurile depășesc Bitcoin în performanță - cu istoric zilnic opțional.

Parametru Tip Descriere
days integer Numărul de zile de istoric zilnic incluse (0–365; 0 returnează doar citirea actuală).
Instrument

get_liquidations_summary

Totalurile lichidărilor de futures de astăzi, cu împărțirea long/short și dominanța. Datele pot fi null imediat după schimbarea zilei.

Acest instrument nu primește parametri.

Burse

Instrument

list_exchanges

Burse clasate, cu volum pe 24h, dominanța volumului și numărul de perechi/active. Convertește de asemenea numele burselor în sluguri.

Parametru Tip Descriere
type enum Restrânge la burse centralizate (cex) sau descentralizate (dex).
search string Căutare în text liber, comparată cu numele burselor.
sort string Câmpuri de sortare separate prin virgulă, prefixul "-" pentru ordine descrescătoare: volume, rank, volume_dominance, change_24h, change_7d, pairs, assets.
limit integer Numărul maxim de burse returnate (1–50, implicit 10).
Instrument

get_exchange

Profil complet pentru o bursă: rang, volum și variații, dominanță, perechi și active listate, plus linkuri.

Parametru Tip Descriere
slug obligatoriu string Slug canonic de bursă, de ex. binance-exchange.
Instrument

get_exchange_trust_score

Scorul de încredere al unei burse (0–10), cu defalcarea completă pe 13 factori. O bursă neclasată (fără volum spot activ încă) returnează un scor și o defalcare null: nu a fost evaluată, ceea ce nu este același lucru cu un scor mic.

Parametru Tip Descriere
slug obligatoriu string Slug canonic de bursă.
Instrument

get_coin_markets

Unde se tranzacționează o monedă: piețele sale de pe burse, cu perechea, prețul și volumul pe 24h, sortate după volum.

Parametru Tip Descriere
slug obligatoriu string Slug canonic de monedă.
exchange string Slug opțional de bursă, pentru a restrânge rezultatele la o singură platformă.
instrument enum Restrânge la un singur tip de instrument: spot, future, option, swap sau margin.
limit integer Numărul maxim de piețe returnate (1–50, implicit 10).

Analiză și utilitare

Instrument

get_coin_technicals

Instantaneul tehnic cu mai mulți indicatori pentru o monedă, într-un singur apel: RSI, MACD, SMA, ADX, MFI, CCI, OBV, VWAP, volatilitate și altele, fiecare cu starea și scorul cele mai recente.

Parametru Tip Descriere
slug obligatoriu string Slug canonic de monedă.
Instrument

convert_currency

Convertește o sumă între orice monede cripto și/sau fiat (până la 10 ținte pe apel), folosind cursuri în timp real, cu precizie zecimală completă.

Parametru Tip Descriere
from obligatoriu string Slugul monedei sursă, de ex. bitcoin sau united-states-dollar.
to obligatoriu string Sluguri de monede țintă separate prin virgulă, până la 10.
amount number Suma din moneda sursă care se convertește (implicit 1).
Instrument

calculate_dca

Rulează un backtest al unei strategii de dollar-cost averaging pe istoricul real al prețurilor: total investit, monede acumulate, valoare actuală și profit/pierdere.

Parametru Tip Descriere
slug obligatoriu string Slug canonic de monedă.
amount obligatoriu number Suma în USD cumpărată la fiecare interval.
interval obligatoriu enum Cadența achizițiilor: daily, weekly, monthly, quarterly sau yearly.
start obligatoriu date Data primei achiziții, în format YYYY-MM-DD (anterioară zilei de azi).
end date Data ultimei achiziții, în format YYYY-MM-DD; implicit, ziua de azi.
series boolean Include seria pentru fiecare achiziție (rezultat mare - păstrați false dacă nu vi se cere altfel).