Bitculator
Bitculatorin MCP-palvelin

Live-kryptodataa tekoälyavustajallesi

Bitculatorin MCP-palvelin avaa kryptomarkkinat 19 valikoituna työkaluna avoimen Model Context Protocolin kautta - kaikki vain lukuoikeudella. Yhdistä kerran, niin avustajasi vastaa live-hinnoilla, historialla, markkinatunnelmalla ja pörssitiedolla.

Päätepiste
https://bitculator.com/mcp
Siirtotapa
Streamable HTTP
Todennus
Bearer-MCP-avain
Työkalut
19 · vain luku

MCP (Model Context Protocol) on avoin standardi, jolla tekoälyasiakkaat käyttävät ulkoisia työkaluja. Mikä tahansa asiakas, joka tukee etäpalvelimia Streamable HTTP -protokollan yli, voi käyttää Bitculatoria - alla käydään läpi suosituimmat. MCP on oma tuotteensa: se laskutetaan omalla suunnitelmallaan, omilla avaimillaan ja omalla kuukausittaisella työkalukutsukvootillaan. Kaikki hinnat, kurssit ja määrät palautetaan muodossa decimal strings tarkkuuden säilyttämiseksi, täsmälleen kuten REST-rajapinnassa. Markkina-arvot ja vaihdot ovat tavallisia JSON-lukuja.

Todennus

Palvelin todentaa MCP-avaimilla: luo avain mcp-oikeudella MCP-konsolissa (ilmainen MCP-suunnitelma riittää - korttia ei tarvita) ja lähetä se Bearer-otsakkeessa jokaisen pyynnön mukana. Data API- ja widget-avaimet hylätään virheellä 401 unauthenticated.

HTTP-otsake
Authorization: Bearer YOUR_API_KEY

Asiakasohjelmat ja yhdyskäytävät, jotka varaavat Authorization-otsakkeen omaa kirjautumistaan varten, kuten Smithery, voivat sen sijaan lähettää saman avaimen otsakkeessa X-API-Key: YOUR_API_KEY.

Pyynnöt ilman kelvollista avainta saavat vastauksen 401 unauthenticated. Avaimet ovat salaisuuksia - määritä ne asiakasohjelman asetuksiin tai ympäristömuuttujaan, ei koskaan versionhallintaan vietäviin jaettuihin tiedostoihin.

Claude Code

Yksi komento rekisteröi palvelimen projektiisi (tai lisää --scope user, niin se on käytettävissä kaikissa projekteissa). Claude valitsee oikean työkalun automaattisesti, kun kysyt markkinoista.

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

Cursor

Lisää palvelin tiedostoon ~/.cursor/mcp.json (globaali) tai projektin tiedostoon .cursor/mcp.json. Työkalut ilmestyvät Cursorin agenttiin heti, kun tiedosto on tallennettu.

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

VS Code

Lisää palvelin työtilasi tiedostoon .vscode/mcp.json. GitHub Copilotin agenttitila listaa Bitculatorin työkalut automaattisesti.

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

Claude API

Rakennatko omaa sovellusta Anthropicin rajapinnan päälle? MCP-liitin tavoittaa palvelimen suoraan Messages API -kutsusta - välitä Bitculatorin MCP-avaimesi kentässä 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 yhdistää etä-MCP-palvelimiin kehittäjätilan kautta:

  1. Ota developer mode käyttöön ChatGPT-asetuksista (Apps & Connectors → Advanced).
  2. Lisää liitin palvelimen osoitteella https://bitculator.com/mcp.
  3. ChatGPT-liittimen todennus perustuu OAuthiin - API-avainotsakkeita ei siellä vielä tueta, joten avainpohjaiseen käyttöön sopii ilman todennusta toimiva asiakas tai Clauden pinnat.

OAuth-kulku (ja sen myötä täysi ChatGPT- ja Claude-hakemistotuki) on tiekartalla. Avainpohjaiset asiakkaat - Claude Code, Cursor, VS Code ja Claude API - toimivat jo nyt.

Kvootti ja rajat

MCP on itsenäinen tuote, jolla on oma suunnitelma, oma kuukausikvootti ja omat avainpaikat - se ei koskaan kuluta Data API- tai widget-kvoottiasi.

  • Jokainen työkalukutsu kuluttaa yhden kutsun MCP-suunnitelmasi kuukausikvootista (Free 2 500, Starter 50 000, Pro 250 000).
  • MCP-suunnitelmasi minuuttikohtainen purskeraja (Free 30, Starter 60, Pro 120) koskee koko päätepistettä, ei pelkkiä työkalukutsuja - initialize, notifications/initialized, tools/list, resources/*, prompts/* ja ping varaavat kukin yhden paikan. Työkalukutsu maksaa silti tasan yhden: sen lähettämä sisäinen Data API -pyyntö on vapautettu omasta purskerajastaan.
  • Kvootin ylityttyä työkalut palauttavat virheen rate_limited, joka kertoo avustajalle, milloin jakso nollautuu. Tasosi ylittävät työkalut palauttavat plan_required.
  • Kättely- ja kartoituskutsut eivät kuluta kuukausikvoottia - vain työkalukutsut kuluttavat - mutta ne varaavat purskepaikkoja. Purskehylkäys on HTTP 429 itse JSON-RPC-pyynnölle, joten asiakas raportoi siirtovirheen eikä työkaluvirhettä.

Agenttikehykset

Rakennatko omaa agenttia? Jokainen merkittävä kehys sisältää MCP-asiakkaan, joka yhdistää Streamable HTTP -protokollan yli Bearer-MCP-avaimella - alla olevat koodinpätkät lataavat kaikki 19 työkalua natiivifunktioina.

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)

Työkaluhakemisto

Kaikki 19 työkalua ovat vain luettavia. Parametrit vastaavat Data API -päätepisteitä - sama validointi, sama desimaalimerkkijonojen tarkkuus - mutta jokaisen työkalun suunnitelmaportti tulee MCP-suunnitelmastasi.

Markkinadata

Työkalu

search_coins

Selvittää kolikon tai tokenin kanonisen slugin vapaan tekstin nimestä tai symbolista ja antaa jokaisesta osumasta järjestetyn markkinayhteenvedon. Aloituspiste: kaikkia muita kolikkotyökaluja kutsutaan slugilla.

Parametri Tyyppi Kuvaus
query pakollinen string Vapaa tekstihaku, joka kohdistuu kolikoiden nimiin ja symboleihin.
type enum Rajaa osumat: coin tai token.
limit integer Enintään palautettavien osumien määrä (1–50, oletus 10).
Työkalu

get_coin

Yhden kolikon täydet tiedot: määrät, sijoitus ja sen muutokset, kaikkien aikojen ylin ja alin sekä etäisyys niistä, täysin laimennettu arvostus, linkit, sopimukset ja kuvaus.

Parametri Tyyppi Kuvaus
slug pakollinen string Kolikon kanoninen slug, esim. bitcoin.
Työkalu

get_prices

Nykyiset spot-hinnat jopa 100 kolikolle yhdellä kutsulla, halutessa muunnettuna fiat-valuuttaan. Halvin tapa vastata hintakysymyksiin - tasan yksi valitsin on pakollinen.

Parametri Tyyppi Kuvaus
slugs string Pilkulla erotellut kolikoiden slugit - suositeltu valitsin.
symbols string Pilkulla erotellut tikkerisymbolit; monitulkintaiset symbolit ratkeavat korkeimmalle sijoittuneeseen osumaan.
ids string Pilkulla erotellut numeeriset Bitculatorin kolikkotunnukset.
convert string Fiat-valuutan symboli, johon hinnat muunnetaan, esim. EUR. Oletus on USD.
Työkalu

get_top_movers

Suurimmat nousijat tai laskijat prosenttimuutoksen mukaan viimeisten 24 tunnin tai 7 päivän aikana.

Parametri Tyyppi Kuvaus
direction pakollinen enum gainers tai losers.
interval enum Muutosikkuna, jonka mukaan järjestetään: 24h tai 7d (oletus 24h).
limit integer Enintään palautettavien kolikoiden määrä (1–50, oletus 10).

Historia

Työkalu

get_price_history

Kolikon OHLCV-kynttilät valitulla aikavälillä. Säilytys: minuuttitaso n. 8 päivää, puolen tunnin taso n. 3 kuukautta, tuntitaso n. 6 kuukautta, päivätaso = koko historia. Palauttaa ikkunan uusimmat kynttilät, vanhin ensin.

Parametri Tyyppi Kuvaus
slug pakollinen string Kolikon kanoninen slug.
interval enum Kynttilän aikaväli: minutely, half-hourly, hourly tai daily (oletus daily).
start date Ikkunan alku muodossa YYYY-MM-DD; oletuksena aikavälille sopiva tuore ikkuna.
end date Ikkunan loppu muodossa YYYY-MM-DD; oletuksena nyt.
limit integer Enintään palautettavien kynttilöiden määrä (1–500, oletus 90).
Työkalu

get_historical_price

Yhden kolikon hinta tiettynä menneenä päivänä; jos tarkalta päivältä ei ole dataa, haku siirtyy enintään 3 päivää taaksepäin.

Parametri Tyyppi Kuvaus
slug pakollinen string Kolikon kanoninen slug.
date pakollinen date Päivä muodossa YYYY-MM-DD (2009-01-01 tai myöhemmin, ei tulevaisuudessa).
Työkalu

get_global_history

Aikasarja koko kryptomarkkinan markkina-arvosta tai kokonaisvaihdosta. Tarkkuus seuraa jaksoa: 24h on puolen tunnin, 7d tunnin, 30d ja all päivän tasolla.

Parametri Tyyppi Kuvaus
metric pakollinen enum Palautettava sarja: marketcap tai volume.
period enum Ikkuna: 24h, 7d, 30d tai all (oletus 24h).

Markkinatunnelma ja globaalit

Työkalu

get_global_market

Tilannekuva koko markkinasta: kokonaismarkkina-arvo, 24 tunnin kokonaisvaihto, BTC- ja ETH-dominanssi sekä kolikoiden, tokenien, pörssien ja parien lukumäärät. Sisältää myös markkinan Fear & Greed -lukeman – käytä arvoa index (0–100), älä raakaa arvoa score.

Tämä työkalu ei ota parametreja.

Työkalu

get_fear_greed

Pelko ja ahneus -tunneindeksi koko markkinalle, tai yhdelle kolikolle kun slug annetaan, mukaan lukien 7d/30d-jaksojen osapisteet. Käytä arvoa index (0–100, kuten Bitculator sen näyttää), älä raakaa arvoa score (−100…+100).

Parametri Tyyppi Kuvaus
coin string Valinnainen kolikon slug kolikkokohtaiseen lukemaan; jätä pois, jos haluat koko markkinan indeksin.
Työkalu

get_altseason_index

Altseason-indeksi - kertoo, tuottavatko altcoinit Bitcoinia paremmin - ja halutessa päivittäinen historia.

Parametri Tyyppi Kuvaus
days integer Mukaan otettavan päivähistorian pituus päivinä (0–365; 0 palauttaa vain nykyisen lukeman).
Työkalu

get_liquidations_summary

Tämän päivän futuurilikvidaatioiden summat long/short-jakaumalla ja dominanssilla. Data voi olla null heti päivän vaihtumisen jälkeen.

Tämä työkalu ei ota parametreja.

Pörssit

Työkalu

list_exchanges

Pörssit järjestyksessä, mukana 24 tunnin vaihto, vaihdon dominanssi sekä parien ja omaisuuserien lukumäärät. Selvittää myös pörssien nimet slugeiksi.

Parametri Tyyppi Kuvaus
type enum Rajaa keskitettyihin (cex) tai hajautettuihin (dex) pörsseihin.
search string Vapaa tekstihaku, joka kohdistuu pörssien nimiin.
sort string Pilkulla erotellut järjestyskentät, etuliite ”-” laskevaan järjestykseen: volume, rank, volume_dominance, change_24h, change_7d, pairs, assets.
limit integer Enintään palautettavien pörssien määrä (1–50, oletus 10).
Työkalu

get_exchange

Yhden pörssin täydet tiedot: sijoitus, vaihto ja sen muutokset, dominanssi, listatut parit ja omaisuuserät sekä linkit.

Parametri Tyyppi Kuvaus
slug pakollinen string Pörssin kanoninen slug, esim. binance-exchange.
Työkalu

get_exchange_trust_score

Pörssin luottamuspisteet (0–10) ja niiden täysi 13 tekijän erittely. Pörssi, jota ei ole vielä asetettu järjestykseen (ei aktiivista spot-vaihtoa), palauttaa null-pisteet ja tyhjän erittelyn: sitä ei ole pisteytetty, mikä ei ole sama asia kuin matalat pisteet.

Parametri Tyyppi Kuvaus
slug pakollinen string Pörssin kanoninen slug.
Työkalu

get_coin_markets

Missä kolikolla käydään kauppaa: sen markkinat eri pörsseissä pareineen, hintoineen ja 24 tunnin vaihtoineen, vaihdon mukaan järjestettynä.

Parametri Tyyppi Kuvaus
slug pakollinen string Kolikon kanoninen slug.
exchange string Valinnainen pörssin slug, joka rajaa tulokset yhteen paikkaan.
instrument enum Rajaa yhteen instrumenttityyppiin: spot, future, option, swap tai margin.
limit integer Enintään palautettavien markkinoiden määrä (1–50, oletus 10).

Analyysi ja apuvälineet

Työkalu

get_coin_technicals

Kolikon monen indikaattorin tekninen tilannekuva yhdellä kutsulla: RSI, MACD, SMA, ADX, MFI, CCI, OBV, VWAP, volatiliteetti ja muita, kukin viimeisimmällä tilallaan ja pisteellään.

Parametri Tyyppi Kuvaus
slug pakollinen string Kolikon kanoninen slug.
Työkalu

convert_currency

Muuntaa summan minkä tahansa krypto- ja fiat-valuuttojen välillä (enintään 10 kohdetta kutsua kohden) live-kursseilla ja täydellä desimaalitarkkuudella.

Parametri Tyyppi Kuvaus
from pakollinen string Lähdevaluutan slug, esim. bitcoin tai united-states-dollar.
to pakollinen string Pilkulla erotellut kohdevaluuttojen slugit, enintään 10.
amount number Muunnettavan lähdevaluutan määrä (oletus 1).
Työkalu

calculate_dca

Testaa DCA-strategiaa takautuvasti todellista hintahistoriaa vasten: sijoitettu yhteensä, kerätyt kolikot, nykyarvo sekä voitto tai tappio.

Parametri Tyyppi Kuvaus
slug pakollinen string Kolikon kanoninen slug.
amount pakollinen number Kullakin ostovälillä ostettava summa dollareissa.
interval pakollinen enum Ostotahti: daily, weekly, monthly, quarterly tai yearly.
start pakollinen date Ensimmäinen ostopäivä muodossa YYYY-MM-DD (ennen tätä päivää).
end date Viimeinen ostopäivä muodossa YYYY-MM-DD; oletuksena tämä päivä.
series boolean Sisällytä ostokohtainen sarja (suuri tuloste - jätä arvoon false, ellei sitä erikseen pyydetä).