Bitculator
Bitculator MCP サーバー

AI アシスタントにライブの暗号資産データを

Bitculator MCP サーバーは、Data API をオープンな Model Context Protocol 上の 19 の厳選された読み取り専用ツールとして公開します。一度接続すれば、アシスタントはライブ価格、履歴、センチメント、取引所インテリジェンスで答えるようになります。

エンドポイント
https://bitculator.com/mcp
トランスポート
Streamable HTTP
認証
Bearer API キー
ツール
19 · 読み取り専用

MCP (Model Context Protocol) は、AI クライアントが外部ツールに到達するために使うオープン標準です。Streamable HTTP 経由のリモートサーバーに対応するクライアントなら何でも Bitculator を利用できます - 以下のセクションでは主要なクライアントを扱います。価格、レート、時価総額、供給量はすべて、REST API とまったく同じように、精度を保つため decimal strings(10 進文字列)として返されます。

認証

サーバーは Data API と同じキーで認証します: 開発者コンソールdata-api アビリティ付きのキーを作成し(無料プランで OK - カード登録不要)、すべてのリクエストで Bearer ヘッダーとして送信してください。埋め込みキーは拒否されます。

HTTP ヘッダー
Authorization: Bearer YOUR_API_KEY

有効なキーのないリクエストは 401 unauthenticated を受け取ります。キーは秘密情報です - クライアントの設定や環境変数で構成し、コミットする共有ファイルには決して書かないでください。

Claude Code

コマンド 1 つでプロジェクトにサーバーを登録できます(--scope user を付ければどこでも使えます)。市場について尋ねると、Claude が自動的に適切なツールを選びます。

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

Cursor

サーバーを ~/.cursor/mcp.json(グローバル)またはプロジェクト内の .cursor/mcp.json に追加します。ファイルを保存すると、Cursor のエージェントにツールが表示されます。

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

VS Code

ワークスペースの .vscode/mcp.json にサーバーを追加します。GitHub Copilot のエージェントモードが Bitculator のツールを自動的に一覧表示します。

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

Claude API

Anthropic API 上で独自のアプリを構築していますか?MCP コネクタは Messages API の呼び出しから直接サーバーに到達します - Bitculator のキーを 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 はデベロッパーモードを通じてリモート MCP サーバーに接続します:

  1. ChatGPT の設定でデベロッパーモードを有効にします(Apps & Connectors → Advanced)。
  2. サーバー URL https://bitculator.com/mcp でコネクタを追加します。
  3. ChatGPT のコネクタ認証は OAuth ベースで、API キーヘッダーはまだサポートされていません。キーベースのアクセスには、認証なしに対応したクライアントか Claude 系のサーフェスを使ってください。

OAuth フロー(それに伴う ChatGPT + Claude ディレクトリの完全サポート)はロードマップにあります。キーベースのクライアント - Claude Code、Cursor、VS Code、Claude API - は今日から利用できます。

クォータと制限

MCP は Data API の消費サーフェスの 1 つです - MCP 専用の請求やプールはありません。

  • すべてのツール呼び出しは、プランの月間クォータに対する Data API リクエスト 1 回としてカウントされます。
  • プランの毎分バースト制限はツール呼び出しごとに適用されます(Free 30、Starter 60、Pro 120)。
  • クォータを超過すると、ツールはプールがいつリセットされるかをアシスタントに伝える rate_limited エラーを返します。プラン制限付きのエンドポイントは plan_required を返します。
  • プロトコルのハンドシェイク(initializetools/list)は無料です - プールから消費されるのはツール呼び出しだけです。

エージェントフレームワーク

独自のエージェントを構築していますか?主要なフレームワークはすべて、Bearer ヘッダー付きの Streamable HTTP で接続する MCP クライアントを備えています。以下のスニペットで 19 個のツールすべてがネイティブ関数として読み込まれます。

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)

ツールリファレンス

19 のツールはすべて読み取り専用です。パラメータは対応する Data API エンドポイントを反映します - 同じバリデーション、同じプラン制限、同じ 10 進文字列の精度です。

マーケットデータ

ツール

search_coins

コインまたはトークンを、自由記述の名前やシンボルから正規のスラッグへ解決し、一致ごとにランク付きの市場サマリーを返します。すべての入口となるツール: 他のコインツールはすべてスラッグで指定します。

パラメータ 説明
query 必須 string コイン名とシンボルに対して照合される自由記述の検索文字列。
type enum 一致を制限: coin または token。
limit integer 返す一致の最大数(1-50、デフォルト 10)。
ツール

get_coin

1 つのコインの完全なプロフィール: 供給量、ランクとランク変動、過去最高値/最安値とそこからの乖離、完全希薄化後評価額、リンク、コントラクト、説明。

パラメータ 説明
slug 必須 string 正規のコインスラッグ。例: bitcoin。
ツール

get_prices

最大 100 コインの現在のスポット価格を 1 回の呼び出しで取得し、必要に応じて法定通貨へ換算できます。価格の質問に答える最も低コストな方法です - セレクタはちょうど 1 つだけ必須です。

パラメータ 説明
slugs string カンマ区切りのコインスラッグ - 推奨のセレクタ。
symbols string カンマ区切りのティッカーシンボル。曖昧なシンボルは最上位ランクの一致に解決されます。
ids string カンマ区切りの数値 Bitculator コイン ID。
convert string 価格の換算先となる法定通貨シンボル。例: EUR。デフォルトは USD。
ツール

get_top_movers

過去 24 時間または 7 日間の変化率で見た、最大の上昇銘柄または下落銘柄。

パラメータ 説明
direction 必須 enum gainers または losers。
interval enum ランク付けに使う変化ウィンドウ: 24h または 7d(デフォルト 24h)。
limit integer 返すコインの最大数(1-50、デフォルト 10)。

履歴

ツール

get_price_history

期間を指定したコインの OHLCV ローソク足。保持期間: 分足 約 8 日、30 分足 約 3 か月、時間足 約 6 か月、日足 = 全履歴。ウィンドウ内の最新のローソク足を、古い順に返します。

パラメータ 説明
slug 必須 string 正規のコインスラッグ。
interval enum ローソク足の間隔: minutely、half-hourly、hourly、daily(デフォルト daily)。
start date ウィンドウの開始(YYYY-MM-DD)。デフォルトは間隔に応じた直近のウィンドウ。
end date ウィンドウの終了(YYYY-MM-DD)。デフォルトは現在。
limit integer 返すローソク足の最大数(1-500、デフォルト 90)。
ツール

get_historical_price

特定の過去の日付における 1 コインの価格。該当日にデータがない場合は最大 3 日間のフォールバックがあります。

パラメータ 説明
slug 必須 string 正規のコインスラッグ。
date 必須 date 日付(YYYY-MM-DD、2009-01-01 以降で未来の日付は不可)。
ツール

get_global_history

暗号資産市場全体の時価総額または総出来高の時系列。粒度は期間に従います: 24h は 30 分毎、7d は 1 時間毎、30d と all は日次。

パラメータ 説明
metric 必須 enum 返す系列: marketcap または volume。
period enum ウィンドウ: 24h、7d、30d、all(デフォルト 24h)。

センチメントとグローバル

ツール

get_global_market

市場全体のスナップショット: 総時価総額、24 時間総出来高、BTC/ETH ドミナンス、コイン/トークン/取引所/ペアの数。

このツールにパラメータはありません。

ツール

get_fear_greed

市場全体、またはスラッグを渡した場合は 1 コインの Fear & Greed センチメント指数。7d/30d インターバルのサブスコアを含みます。

パラメータ 説明
coin string コイン単位の値を得るためのオプションのコインスラッグ。省略すると市場全体の指数。
ツール

get_altseason_index

アルトシーズン指数 - アルトコインがビットコインをアウトパフォームしているかどうか - をオプションの日次履歴付きで返します。

パラメータ 説明
days integer 含める日次履歴の日数(0-365。0 は現在の値のみを返します)。
ツール

get_liquidations_summary

本日の先物清算合計。ロング/ショートの内訳とドミナンス付き。日次ロールオーバーの直後はデータが null になることがあります。

このツールにパラメータはありません。

取引所

ツール

list_exchanges

24 時間出来高、出来高ドミナンス、ペア/銘柄数付きのランク付けされた取引所。取引所名からスラッグへの解決も行います。

パラメータ 説明
type enum 中央集権型(cex)または分散型(dex)の取引所に制限。
search string 取引所名に対して照合される自由記述の検索文字列。
sort string カンマ区切りのソートフィールド。降順は「-」プレフィックス: volume、rank、volume_dominance、change_24h、change_7d、pairs、assets。
limit integer 返す取引所の最大数(1-50、デフォルト 10)。
ツール

get_exchange

1 つの取引所の完全なプロフィール: ランク、出来高と変動、ドミナンス、上場ペアと銘柄、リンク。

パラメータ 説明
slug 必須 string 正規の取引所スラッグ。例: binance-exchange。
ツール

get_exchange_trust_score

取引所の信頼スコア(0-10)と、その 13 要素の完全な内訳。

パラメータ 説明
slug 必須 string 正規の取引所スラッグ。
ツール

get_coin_markets

コインの取引場所: 取引所をまたぐ市場を、ペア、価格、24 時間出来高付きで、出来高順に返します。

パラメータ 説明
slug 必須 string 正規のコインスラッグ。
exchange string 結果を 1 つの取引所に制限するためのオプションの取引所スラッグ。
instrument enum 1 つの商品タイプに制限: spot、future、option、swap、margin。
limit integer 返す市場の最大数(1-50、デフォルト 10)。

分析とユーティリティ

ツール

get_coin_technicals

1 回の呼び出しで得られるコインのマルチインジケーター・テクニカルスナップショット: RSI、MACD、SMA、ADX、MFI、CCI、OBV、VWAP、ボラティリティなど。それぞれ最新の状態とスコア付き。

パラメータ 説明
slug 必須 string 正規のコインスラッグ。
ツール

convert_currency

ライブレートを使って、任意の暗号資産および/または法定通貨間で金額を換算します(1 回の呼び出しで最大 10 の換算先)。完全な小数精度で。

パラメータ 説明
from 必須 string 換算元通貨のスラッグ。例: bitcoin、united-states-dollar。
to 必須 string カンマ区切りの換算先通貨スラッグ。最大 10 個。
amount number 換算する換算元通貨の金額(デフォルト 1)。
ツール

calculate_dca

ドルコスト平均法の戦略を実際の価格履歴に対してバックテスト: 総投資額、累積コイン数、現在価値、損益。

パラメータ 説明
slug 必須 string 正規のコインスラッグ。
amount 必須 number 各インターバルで購入する USD 金額。
interval 必須 enum 購入頻度: daily、weekly、monthly、quarterly、yearly。
start 必須 date 最初の購入日(YYYY-MM-DD、今日より前)。
end date 最後の購入日(YYYY-MM-DD)。デフォルトは今日。
series boolean 購入ごとの系列を含める(出力が大きくなるため、求められない限り false のままにしてください)。