Bitculator
Server MCP Bitculator

Data kripto live untuk asisten AI Anda

Server MCP Bitculator mengekspos Data API sebagai 19 alat hanya-baca yang dikurasi lewat Model Context Protocol yang terbuka. Hubungkan sekali dan asisten Anda menjawab dengan harga live, riwayat, sentimen, dan intelijen exchange.

Endpoint
https://bitculator.com/mcp
Transport
Streamable HTTP
Autentikasi
API key Bearer
Alat
19 · hanya-baca

MCP (Model Context Protocol) adalah standar terbuka yang dipakai AI client untuk menjangkau alat eksternal. Client mana pun yang mendukung server jarak jauh lewat Streamable HTTP dapat memakai Bitculator — bagian di bawah membahas yang populer. Semua harga, kurs, marketcap, dan suplai dikembalikan sebagai decimal strings untuk menjaga presisi, persis seperti REST API.

Autentikasi

Server ini melakukan autentikasi dengan key yang sama seperti Data API: buat key dengan kemampuan data-api di konsol developer (paket gratis bisa dipakai — tanpa perlu kartu) dan kirimkan sebagai header Bearer pada setiap permintaan. Embed key ditolak.

Header HTTP
Authorization: Bearer YOUR_API_KEY

Permintaan tanpa key yang valid menerima 401 unauthenticated. Key adalah rahasia — konfigurasikan di pengaturan client Anda atau variabel lingkungan, jangan pernah di file bersama yang Anda commit.

Claude Code

Satu perintah mendaftarkan server untuk proyek Anda (atau tambahkan --scope user agar tersedia di mana saja). Claude otomatis memilih alat yang tepat saat Anda bertanya tentang pasar.

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

Cursor

Tambahkan server ke ~/.cursor/mcp.json (global) atau .cursor/mcp.json di sebuah proyek. Alat-alatnya muncul di agen Cursor begitu file disimpan.

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

VS Code

Tambahkan server ke .vscode/mcp.json di workspace Anda. Mode agen GitHub Copilot otomatis menampilkan daftar alat Bitculator.

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

Claude API

Sedang membangun aplikasi sendiri di atas Anthropic API? MCP connector menjangkau server langsung dari panggilan Messages API — teruskan key Bitculator Anda sebagai 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 terhubung ke server MCP jarak jauh melalui mode developer:

  1. Aktifkan mode developer di pengaturan ChatGPT (Apps & Connectors → Advanced).
  2. Tambahkan konektor dengan URL server https://bitculator.com/mcp.
  3. Autentikasi konektor ChatGPT berbasis OAuth — header API key belum didukung di sana, jadi gunakan client yang mendukung tanpa-autentikasi atau permukaan Claude untuk akses berbasis key.

Alur OAuth (dan bersamanya dukungan penuh direktori ChatGPT + Claude) ada di roadmap. Client berbasis key — Claude Code, Cursor, VS Code, Claude API — sudah bekerja hari ini.

Kuota & batas

MCP adalah permukaan konsumsi dari Data API — tidak ada tagihan atau pool MCP terpisah.

  • Setiap panggilan alat dihitung sebagai satu permintaan Data API terhadap kuota bulanan paket Anda.
  • Batas burst per menit dari paket Anda berlaku per panggilan alat (Free 30, Starter 60, Pro 120).
  • Saat melebihi kuota, alat mengembalikan error rate_limited yang memberi tahu asisten kapan pool di-reset. Endpoint yang dibatasi paket mengembalikan plan_required.
  • Jabat tangan protokol (initialize, tools/list) gratis — hanya panggilan alat yang menarik dari pool.

Framework agen

Membangun agen Anda sendiri? Semua framework besar menyertakan klien MCP yang terhubung melalui Streamable HTTP dengan header Bearer - cuplikan di bawah memuat semua 19 alat sebagai fungsi bawaan.

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)

Referensi alat

Semua 19 alat bersifat hanya-baca. Parameternya mencerminkan endpoint Data API yang bersangkutan — validasi yang sama, gerbang paket yang sama, presisi string desimal yang sama.

Data pasar

Alat

search_coins

Memetakan koin atau token dari nama atau simbol teks-bebas ke slug kanoniknya, dengan ringkasan pasar berperingkat per kecocokan. Ini titik masuknya: setiap alat koin lainnya dialamatkan lewat slug.

Parameter Tipe Deskripsi
query wajib string Pencarian teks-bebas yang dicocokkan dengan nama dan simbol koin.
type enum Batasi kecocokan: coin atau token.
limit integer Kecocokan maksimum yang dikembalikan (1–50, default 10).
Alat

get_coin

Profil lengkap satu koin: suplai, peringkat dan perubahan peringkat, titik tertinggi/terendah sepanjang masa dan jaraknya, valuasi terdilusi penuh, tautan, kontrak, dan deskripsi.

Parameter Tipe Deskripsi
slug wajib string Slug koin kanonik, mis. bitcoin.
Alat

get_prices

Harga spot terkini hingga 100 koin dalam satu panggilan, opsional dikonversi ke mata uang fiat. Cara termurah menjawab pertanyaan harga — tepat satu selektor yang wajib diisi.

Parameter Tipe Deskripsi
slugs string Slug koin dipisahkan koma — selektor yang disarankan.
symbols string Simbol ticker dipisahkan koma; simbol yang ambigu dipetakan ke kecocokan berperingkat tertinggi.
ids string Id koin numerik Bitculator dipisahkan koma.
convert string Simbol mata uang fiat untuk mengonversi harga, mis. EUR. Default USD.
Alat

get_top_movers

Gainer atau loser terbesar berdasarkan persentase perubahan selama 24 jam atau 7 hari terakhir.

Parameter Tipe Deskripsi
direction wajib enum gainers atau losers.
interval enum Jendela perubahan untuk pemeringkatan: 24h atau 7d (default 24h).
limit integer Koin maksimum yang dikembalikan (1–50, default 10).

Riwayat

Alat

get_price_history

Candle OHLCV sebuah koin dalam rentang tanggal. Retensi: per menit ~8 hari, per setengah jam ~3 bulan, per jam ~6 bulan, harian = riwayat penuh. Mengembalikan candle terbaru dalam jendela, yang tertua lebih dulu.

Parameter Tipe Deskripsi
slug wajib string Slug koin kanonik.
interval enum Interval candle: minutely, half-hourly, hourly, atau daily (default daily).
start date Awal jendela sebagai YYYY-MM-DD; default ke jendela terkini yang sesuai intervalnya.
end date Akhir jendela sebagai YYYY-MM-DD; default ke sekarang.
limit integer Candle maksimum yang dikembalikan (1–500, default 90).
Alat

get_historical_price

Harga satu koin pada satu tanggal tertentu di masa lalu, dengan fallback hingga 3 hari saat tanggal persisnya tidak punya data.

Parameter Tipe Deskripsi
slug wajib string Slug koin kanonik.
date wajib date Tanggal sebagai YYYY-MM-DD (2009-01-01 atau setelahnya, bukan di masa depan).
Alat

get_global_history

Deret waktu total marketcap kripto atau total volume. Granularitas mengikuti periode: 24h per setengah jam, 7d per jam, 30d dan all harian.

Parameter Tipe Deskripsi
metric wajib enum Deret yang dikembalikan: marketcap atau volume.
period enum Jendela: 24h, 7d, 30d, atau all (default 24h).

Sentimen & global

Alat

get_global_market

Snapshot seluruh pasar: total marketcap, total volume 24 jam, dominasi BTC/ETH, dan jumlah koin/token/exchange/pasangan.

Alat ini tidak menerima parameter.

Alat

get_fear_greed

Indeks sentimen Fear & Greed untuk seluruh pasar, atau untuk satu koin saat slug diberikan, termasuk sub-skor interval 7d/30d.

Parameter Tipe Deskripsi
coin string Slug koin opsional untuk pembacaan per koin; kosongkan untuk indeks seluruh pasar.
Alat

get_altseason_index

Indeks altseason — apakah altcoin sedang mengungguli Bitcoin — dengan riwayat harian opsional.

Parameter Tipe Deskripsi
days integer Hari riwayat harian yang disertakan (0–365; 0 hanya mengembalikan pembacaan saat ini).
Alat

get_liquidations_summary

Total likuidasi futures hari ini dengan pembagian long/short dan dominasinya. Data bisa null tepat setelah rollover harian.

Alat ini tidak menerima parameter.

Exchange

Alat

list_exchanges

Exchange berperingkat dengan volume 24 jam, dominasi volume, dan jumlah pasangan/aset. Juga memetakan nama exchange ke slug.

Parameter Tipe Deskripsi
type enum Batasi ke exchange tersentralisasi (cex) atau terdesentralisasi (dex).
search string Pencarian teks-bebas yang dicocokkan dengan nama exchange.
sort string Bidang pengurutan dipisahkan koma, awalan "-" untuk menurun: volume, rank, volume_dominance, change_24h, change_7d, pairs, assets.
limit integer Exchange maksimum yang dikembalikan (1–50, default 10).
Alat

get_exchange

Profil lengkap satu exchange: peringkat, volume dan perubahannya, dominasi, pasangan dan aset yang terdaftar, serta tautan.

Parameter Tipe Deskripsi
slug wajib string Slug exchange kanonik, mis. binance-exchange.
Alat

get_exchange_trust_score

Trust score sebuah exchange (0–10) dengan rincian lengkap 13 faktornya.

Parameter Tipe Deskripsi
slug wajib string Slug exchange kanonik.
Alat

get_coin_markets

Di mana sebuah koin diperdagangkan: pasar-pasarnya di berbagai exchange dengan pasangan, harga, dan volume 24 jam, diurutkan berdasarkan volume.

Parameter Tipe Deskripsi
slug wajib string Slug koin kanonik.
exchange string Slug exchange opsional untuk membatasi hasil ke satu tempat perdagangan.
instrument enum Batasi ke satu tipe instrumen: spot, future, option, swap, atau margin.
limit integer Pasar maksimum yang dikembalikan (1–50, default 10).

Analisis & utilitas

Alat

get_coin_technicals

Snapshot teknikal multi-indikator sebuah koin dalam satu panggilan: RSI, MACD, SMA, ADX, MFI, CCI, OBV, VWAP, volatilitas, dan lainnya, masing-masing dengan status dan skor terbarunya.

Parameter Tipe Deskripsi
slug wajib string Slug koin kanonik.
Alat

convert_currency

Konversikan sejumlah nilai antara mata uang kripto dan/atau fiat mana pun (hingga 10 target per panggilan) memakai kurs live, dengan presisi desimal penuh.

Parameter Tipe Deskripsi
from wajib string Slug mata uang sumber, mis. bitcoin atau united-states-dollar.
to wajib string Slug mata uang target dipisahkan koma, hingga 10.
amount number Jumlah mata uang sumber yang dikonversi (default 1).
Alat

calculate_dca

Backtest strategi dollar-cost-averaging terhadap riwayat harga nyata: total yang diinvestasikan, koin yang terakumulasi, nilai saat ini, dan laba/rugi.

Parameter Tipe Deskripsi
slug wajib string Slug koin kanonik.
amount wajib number Jumlah USD yang dibeli pada tiap interval.
interval wajib enum Irama pembelian: daily, weekly, monthly, quarterly, atau yearly.
start wajib date Tanggal pembelian pertama sebagai YYYY-MM-DD (sebelum hari ini).
end date Tanggal pembelian terakhir sebagai YYYY-MM-DD; default hari ini.
series boolean Sertakan deret per pembelian (keluaran besar — biarkan false kecuali diminta).