Bitculator
Bitculator MCP Sunucusu

AI asistanınız için canlı kripto verisi

Bitculator MCP sunucusu, Data API'yi açık Model Context Protocol üzerinden 19 özenle seçilmiş, salt okunur araç olarak sunar. Bir kez bağlanın; asistanınız canlı fiyatlar, geçmiş veriler, duyarlılık ve borsa istihbaratıyla yanıt versin.

Uç nokta
https://bitculator.com/mcp
Taşıma
Streamable HTTP
Kimlik doğrulama
Bearer API anahtarı
Araçlar
19 · salt okunur

MCP (Model Context Protocol), AI istemcilerinin harici araçlara erişmek için kullandığı açık standarttır. Streamable HTTP üzerinden uzak sunucuları destekleyen her istemci Bitculator'ı kullanabilir - aşağıdaki bölümler popüler olanları kapsar. Tüm fiyatlar, kurlar, piyasa değerleri ve arzlar, tıpkı REST API'deki gibi, hassasiyeti korumak için decimal strings (ondalık dizeler) olarak döndürülür.

Kimlik doğrulama

Sunucu, Data API ile aynı anahtarlarla kimlik doğrular: geliştirici konsolunda data-api yetkisine sahip bir anahtar oluşturun (ücretsiz plan yeterlidir - kart gerekmez) ve her istekte Bearer başlığı olarak gönderin. Embed anahtarları reddedilir.

HTTP başlığı
Authorization: Bearer YOUR_API_KEY

Geçerli anahtarı olmayan istekler 401 unauthenticated alır. Anahtarlar gizlidir - onları istemcinizin ayarlarında veya bir ortam değişkeninde yapılandırın, asla commit ettiğiniz paylaşılan dosyalara yazmayın.

Claude Code

Tek bir komut, sunucuyu projeniz için kaydeder (her yerde kullanılabilir yapmak için --scope user ekleyin). Piyasa hakkında soru sorduğunuzda Claude doğru aracı otomatik seçer.

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

Cursor

Sunucuyu ~/.cursor/mcp.json (küresel) ya da bir projedeki .cursor/mcp.json dosyasına ekleyin. Dosya kaydedilir kaydedilmez araçlar Cursor'ın ajanında görünür.

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

VS Code

Sunucuyu çalışma alanınızdaki .vscode/mcp.json dosyasına ekleyin. GitHub Copilot'un ajan modu Bitculator araçlarını otomatik olarak listeler.

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

Claude API

Anthropic API üzerinde kendi uygulamanızı mı geliştiriyorsunuz? MCP bağlayıcısı, bir Messages API çağrısından sunucuya doğrudan ulaşır - Bitculator anahtarınızı authorization_token olarak geçirin.

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, uzak MCP sunucularına geliştirici modu üzerinden bağlanır:

  1. ChatGPT ayarlarında geliştirici modunu etkinleştirin (Apps & Connectors → Advanced).
  2. https://bitculator.com/mcp sunucu URL'siyle bir bağlayıcı ekleyin.
  3. ChatGPT'nin bağlayıcı kimlik doğrulaması OAuth tabanlıdır - API anahtarı başlıkları orada henüz desteklenmiyor; anahtar tabanlı erişim için kimlik doğrulamasız çalışabilen bir istemci ya da Claude yüzeylerini kullanın.

Bir OAuth akışı (ve onunla birlikte tam ChatGPT + Claude dizin desteği) yol haritamızda. Anahtar tabanlı istemciler - Claude Code, Cursor, VS Code, Claude API - bugün çalışıyor.

Kota ve limitler

MCP, Data API'nin bir tüketim yüzeyidir - ayrı bir MCP faturası veya havuzu yoktur.

  • Her araç çağrısı, planınızın aylık kotasına karşı bir Data API isteği olarak sayılır.
  • Planınızın dakika başına ani istek limiti araç çağrısı başına uygulanır (Free 30, Starter 60, Pro 120).
  • Kota aşıldığında araçlar, asistana havuzun ne zaman sıfırlanacağını söyleyen bir rate_limited hatası döndürür. Plan kısıtlı uç noktalar plan_required döndürür.
  • Protokol el sıkışması (initialize, tools/list) ücretsizdir - havuzdan yalnızca araç çağrıları düşer.

Ajan framework'leri

Kendi ajanınızı mı geliştiriyorsunuz? Tüm büyük framework'ler, Bearer başlığıyla Streamable HTTP üzerinden bağlanan bir MCP istemcisi içerir - aşağıdaki kod parçaları 19 aracın tümünü yerel fonksiyonlar gibi yükler.

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)

Araç referansı

19 aracın tümü salt okunurdur. Parametreler karşılık gelen Data API uç noktalarını yansıtır - aynı doğrulama, aynı plan kapıları, aynı ondalık dize hassasiyeti.

Piyasa verisi

Araç

search_coins

Bir coin veya token'ı serbest metin ad ya da sembolden kanonik slug'ına çözümler; her eşleşme için sıralı bir piyasa özeti döndürür. Giriş noktası: diğer tüm coin araçları slug ile adreslenir.

Parametre Tür Açıklama
query zorunlu string Coin adları ve sembollerine karşı eşleştirilen serbest metin arama.
type enum Eşleşmeleri kısıtlar: coin veya token.
limit integer Döndürülecek en fazla eşleşme (1-50, varsayılan 10).
Araç

get_coin

Tek bir coinin eksiksiz profili: arzlar, sıralama ve sıralama değişimleri, tüm zamanların en yüksek/en düşük değeri ve bunlara uzaklık, tamamen seyreltilmiş değerleme, bağlantılar, kontratlar ve açıklama.

Parametre Tür Açıklama
slug zorunlu string Kanonik coin slug'ı, örn. bitcoin.
Araç

get_prices

Tek çağrıda 100 coine kadar güncel spot fiyatlar; istenirse bir fiat para birimine dönüştürülür. Fiyat sorularını yanıtlamanın en ucuz yolu - tam olarak bir seçici zorunludur.

Parametre Tür Açıklama
slugs string Virgülle ayrılmış coin slug'ları - tercih edilen seçici.
symbols string Virgülle ayrılmış sembol kodları; belirsiz semboller en yüksek sıralı eşleşmeye çözümlenir.
ids string Virgülle ayrılmış sayısal Bitculator coin id'leri.
convert string Fiyatların dönüştürüleceği fiat para birimi sembolü, örn. EUR. Varsayılan USD.
Araç

get_top_movers

Son 24 saat veya 7 gündeki yüzde değişime göre en çok kazananlar ya da kaybedenler.

Parametre Tür Açıklama
direction zorunlu enum gainers veya losers.
interval enum Sıralamada kullanılacak değişim penceresi: 24h veya 7d (varsayılan 24h).
limit integer Döndürülecek en fazla coin (1-50, varsayılan 10).

Geçmiş

Araç

get_price_history

Bir coinin bir tarih aralığındaki OHLCV mumları. Saklama: dakikalık ~8 gün, yarım saatlik ~3 ay, saatlik ~6 ay, günlük = tüm geçmiş. Penceredeki en yeni mumları, en eskisi önce olacak şekilde döndürür.

Parametre Tür Açıklama
slug zorunlu string Kanonik coin slug'ı.
interval enum Mum aralığı: minutely, half-hourly, hourly veya daily (varsayılan daily).
start date Pencere başlangıcı, YYYY-MM-DD biçiminde; varsayılan, aralığa uygun yakın bir penceredir.
end date Pencere sonu, YYYY-MM-DD biçiminde; varsayılan şimdi.
limit integer Döndürülecek en fazla mum (1-500, varsayılan 90).
Araç

get_historical_price

Tek bir coinin geçmişteki belirli bir tarihteki fiyatı; ilgili günde veri yoksa 3 güne kadar geriye düşer.

Parametre Tür Açıklama
slug zorunlu string Kanonik coin slug'ı.
date zorunlu date Tarih, YYYY-MM-DD biçiminde (2009-01-01 veya sonrası, gelecekte olmamalı).
Araç

get_global_history

Toplam kripto piyasa değerinin veya toplam hacmin zaman serisi. Ayrıntı düzeyi periyodu izler: 24h yarım saatlik, 7d saatlik, 30d ve all günlüktür.

Parametre Tür Açıklama
metric zorunlu enum Döndürülecek seri: marketcap veya volume.
period enum Pencere: 24h, 7d, 30d veya all (varsayılan 24h).

Duyarlılık ve küresel

Araç

get_global_market

Tüm piyasanın anlık görüntüsü: toplam piyasa değeri, toplam 24 saatlik hacim, BTC/ETH hakimiyeti ve coin/token/borsa/parite sayıları.

Bu araç parametre almaz.

Araç

get_fear_greed

Tüm piyasa için, ya da bir slug geçirildiğinde tek bir coin için Korku ve Açgözlülük duyarlılık endeksi; 7d/30d aralık alt puanlarıyla birlikte.

Parametre Tür Açıklama
coin string Coin bazında okuma için isteğe bağlı coin slug'ı; piyasa geneli endeks için boş bırakın.
Araç

get_altseason_index

Altseason endeksi - altcoinlerin Bitcoin'den daha iyi performans gösterip göstermediği - isteğe bağlı günlük geçmişle.

Parametre Tür Açıklama
days integer Dahil edilecek günlük geçmiş gün sayısı (0-365; 0 yalnızca güncel okumayı döndürür).
Araç

get_liquidations_summary

Bugünün vadeli işlem likidasyon toplamları; long/short dağılımı ve hakimiyetle birlikte. Günlük devrilmenin hemen ardından veri null olabilir.

Bu araç parametre almaz.

Borsalar

Araç

list_exchanges

24 saatlik hacim, hacim hakimiyeti ve parite/varlık sayılarıyla sıralanmış borsalar. Borsa adlarını da slug'lara çözümler.

Parametre Tür Açıklama
type enum Merkezi (cex) veya merkeziyetsiz (dex) borsalarla sınırlar.
search string Borsa adlarına karşı eşleştirilen serbest metin arama.
sort string Virgülle ayrılmış sıralama alanları, azalan için "-" öneki: volume, rank, volume_dominance, change_24h, change_7d, pairs, assets.
limit integer Döndürülecek en fazla borsa (1-50, varsayılan 10).
Araç

get_exchange

Tek bir borsanın eksiksiz profili: sıralama, hacim ve değişimler, hakimiyet, listelenen pariteler ve varlıklar, bağlantılar.

Parametre Tür Açıklama
slug zorunlu string Kanonik borsa slug'ı, örn. binance-exchange.
Araç

get_exchange_trust_score

Bir borsanın güven puanı (0-10) ve 13 faktörlü tam dökümü.

Parametre Tür Açıklama
slug zorunlu string Kanonik borsa slug'ı.
Araç

get_coin_markets

Bir coinin nerede işlem gördüğü: borsalar genelindeki piyasaları; parite, fiyat ve 24 saatlik hacimle, hacme göre sıralı.

Parametre Tür Açıklama
slug zorunlu string Kanonik coin slug'ı.
exchange string Sonuçları tek bir borsayla sınırlamak için isteğe bağlı borsa slug'ı.
instrument enum Tek bir enstrüman türüyle sınırlar: spot, future, option, swap veya margin.
limit integer Döndürülecek en fazla piyasa (1-50, varsayılan 10).

Analiz ve yardımcı araçlar

Araç

get_coin_technicals

Bir coinin çok göstergeli teknik anlık görüntüsü tek çağrıda: RSI, MACD, SMA, ADX, MFI, CCI, OBV, VWAP, volatilite ve daha fazlası; her biri en güncel durumu ve puanıyla.

Parametre Tür Açıklama
slug zorunlu string Kanonik coin slug'ı.
Araç

convert_currency

Bir tutarı, canlı kurlarla herhangi kripto ve/veya fiat para birimleri arasında dönüştürün (çağrı başına 10 hedefe kadar), tam ondalık hassasiyetle.

Parametre Tür Açıklama
from zorunlu string Kaynak para birimi slug'ı, örn. bitcoin veya united-states-dollar.
to zorunlu string Virgülle ayrılmış hedef para birimi slug'ları, en fazla 10.
amount number Dönüştürülecek kaynak para birimi tutarı (varsayılan 1).
Araç

calculate_dca

Bir maliyet ortalaması (DCA) stratejisini gerçek fiyat geçmişine karşı geriye dönük test edin: toplam yatırılan tutar, biriken coinler, güncel değer ve kâr/zarar.

Parametre Tür Açıklama
slug zorunlu string Kanonik coin slug'ı.
amount zorunlu number Her aralıkta satın alınan USD tutarı.
interval zorunlu enum Satın alma sıklığı: daily, weekly, monthly, quarterly veya yearly.
start zorunlu date İlk satın alma tarihi, YYYY-MM-DD biçiminde (bugünden önce).
end date Son satın alma tarihi, YYYY-MM-DD biçiminde; varsayılan bugün.
series boolean Satın alma bazında seriyi dahil eder (büyük çıktı - istenmedikçe false bırakın).