bitbank-lab-mcp
OfficialSummary: An MCP server that pulls bitbank market data, computes technical/market analytics server-side, renders charts, and (with API keys) can read account data and place/cancel orders with confirmation.
Market data: single-pair ticker, all-JPY tickers with ranking/sorting, order book (summary / pressure / statistics / raw), candles from 1min to 1month, trade history with price/amount filters.
Flow & microstructure:
get_flow_metrics(CVD, aggressor ratio, spikes via hours /date/since–until), volume profile (VWAP±σ, POC, value area), whale/large-order detection.Technical indicators: SMA / EMA snapshots, multi-timeframe SMA alignment, Bollinger Bands, Ichimoku, Stochastic, MACD cross screening, plus
analyze_indicatorsand a compositeanalyze_market_signalscore (-100 to +100).Pattern & level analysis: support/resistance detection, Fibonacci retracement/extension (single and MTF confluence), candlestick patterns, and chart patterns (double top/bottom, H&S, triangles, wedges, flags) with a
debugview explaining rejections.Risk/volatility & screening: realized vol, ATR, Parkinson, Garman-Klass, Rogers-Satchell; currency-strength ranking across JPY pairs.
Visualization:
prepare_chart_data/prepare_depth_datafor client-side visualizers;render_chart_svg,render_depth_svg,render_candle_pattern_diagramfor server-side SVG/PNG files.Backtesting:
run_backtestwith sma_cross / rsi / macd_cross / bb_breakout, 1M–3Y or custom date range, 1D/4H/1H timeframe, equity & drawdown curves (and SVG output).Data quality:
validate_candle_datascores completeness, duplicates, OHLCV consistency and outliers (0–100, A–F) with liquidity-tier-aware thresholds.Account (API key required, per README): balances, orders, trades, deposits/withdrawals, margin and P&L analysis; order preview plus token-confirmed create/cancel, execution only when
BITBANK_MCP_APPS_EXECUTE=1.Maintenance:
refresh_pairs_cacheto force-refresh cached maker/taker fee rates.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@bitbank-lab-mcp Analyze BTC/JPY with RSI and Bollinger Bands"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
bitbank-lab-mcp
bitbank API のデータで暗号資産の市場分析をする MCP サーバーです。Claude / Cursor / Codex / Antigravity CLI などから使えます。
はじめにお読みください
本ツールは開発段階(ベータ版)です。利用は自己責任でお願いします。
ご利用の前に必ず ⚠️ 免責事項 をお読みください。
本リポジトリは bitbank バグバウンティプログラムの対象範囲外 です。
Related MCP server: bitbank MCP Server
できること
データ:ティッカー・板・約定履歴・ローソク足(1 分足〜月足)
分析:テクニカル指標(SMA / RSI / ボリンジャーバンド / 一目均衡表 / MACD)・フロー・ボラティリティ・板の圧力・パターン検出・総合スコア
可視化:Claude.ai の Visualizer 向けデータ(
prepare_chart_dataほか)、SVG / PNG(render_chart_svgほか)口座(API キーが必要):資産・注文・約定・入出金・信用・損益の分析、確認つきの発注・取消
指標の計算までサーバーで行い、結果を LLM に渡します。生データを LLM に計算させたいときは、姉妹プロジェクトの bitbank-lab-cli を使ってください。ツールの一覧は docs/tools.md。
クイックスタート
Node.js 22 以上(24 推奨)が必要です。npm の bitbank-lab-mcp を npx で起動するので、clone は要りません。
1. Claude Desktop に登録
設定ファイルに追加し、Claude Desktop を再起動します(macOS は Cmd+Q、Windows は完全終了)。
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
A. 公開データだけ(API キー不要)
{
"mcpServers": {
"bitbank-lab": {
"command": "npx",
"args": ["-y", "bitbank-lab-mcp"]
}
}
}B. 口座の参照(API キーが必要)
キーの権限を「参照」だけにすれば、発注はできません。
{
"mcpServers": {
"bitbank-lab": {
"command": "npx",
"args": ["-y", "bitbank-lab-mcp"],
"env": {
"BITBANK_API_KEY": "your_api_key",
"BITBANK_API_SECRET": "your_api_secret"
}
}
}
}C. 発注・取消まで(API キーが必要)
B に BITBANK_MCP_APPS_EXECUTE=1 を足すと、確認カードのボタンで発注・取消できます(既定は無効)。
{
"mcpServers": {
"bitbank-lab": {
"command": "npx",
"args": ["-y", "bitbank-lab-mcp"],
"env": {
"BITBANK_API_KEY": "your_api_key",
"BITBANK_API_SECRET": "your_api_secret",
"BITBANK_MCP_APPS_EXECUTE": "1"
}
}
}
}確認トークンを、ツール結果の _meta と、一覧に出さないリソース bitbank-confirmation://{app} に載せてカードへ渡します。安全性は「ホストが _meta をモデルに渡さず、MCP リソースもモデルに読ませない」ことに依存します。
仕様上の保証ではありません(MCP Apps 仕様の "Best Practices" の記述で、MUST / SHOULD ではない)
ホストの更新で前提が崩れても、サーバーは検知できません
確認の状態(トークンと注文内容)を
~/.bitbank-lab-mcp/confirmに置きます。ファイルを読める AI エージェントには、このフォルダを許可しないでくださいWindows では、Claude Desktop のボタンが出ない見込みです(未確認)
トークンが漏れた場合の被害は、直前にプレビューした注文 1 件(一括取消なら 1 セット)が、期限(既定 60 秒、最長 5 分)内に 1 回実行されることに限られます。金額・数量・ペア・方向は変えられません。詳細は ADR-0007。
API キーの権限は「API キー」を参照してください(「出金」は付けない)。
2. ほかのクライアント
Claude Code:
claude mcp add --transport stdio bitbank-lab -- npx -y bitbank-lab-mcpCursor(
.cursor/mcp.json)・Windsurf など:上と同じ JSON で登録します。
3. Plugin として入れる(同梱 Skill も使う)
Claude Code では、同梱の Skill(investment-onboarding など)も一緒に入ります。Claude Desktop は plugin に未対応です。
/plugin marketplace add bitbankinc/bitbank-lab-mcp
/plugin install bitbank-lab-mcp@bitbank-lab
/reload-pluginsAPI キーは install 後の画面で入力します(公開データだけなら空欄で OK)。Cursor・Codex・Antigravity CLI 向けの manifest もあります(Cursor・Codex は環境変数でキーを渡します)。
4. 使ってみる
BTCの今の市場状況を分析して
ビットコインは買いと売りどちらが優勢?
直近 1 週間でテクニカル的に上向きの仮想通貨を 3 つ教えて何を聞けばよいか迷ったら、プロンプト集 を見てください。
API キー
キーを設定すると、口座のツールとプロンプトが使えるようになります(未設定なら表示されません)。
bitbank の設定画面 で発行し、必要な権限だけを付けてください。可能なら IP 制限も設定してください。
使い方 | 権限 |
資産・注文・損益を見るだけ | 「参照」 |
発注・取消もする | 「参照」+「取引」 |
⚠️ 「出金」権限は付けないでください。出金のツールはありません。
キーの渡し方:Claude Desktop は設定の env(上の B / C)、Claude Code の plugin は install 後の画面、それ以外は環境変数 BITBANK_API_KEY / BITBANK_API_SECRET。
発注・取消の確認
発注・取消は、プレビューのあとにユーザーの確認が要ります。確認トークンなしで create_order などを呼んでも拒否されます。
クライアント | 実行のしかた |
elicitation 対応 | 確認ダイアログ(追加の設定なし) |
MCP Apps UI 対応(Claude Desktop など) |
|
どちらも非対応 | プレビューだけ(実行は bitbank のアプリ・ウェブで) |
詳細は Private API ガイド。
困ったとき
「サーバーに接続できません」・
spawn npx ENOENT:Claude Desktop がnpxを見つけられていません。which npx(Windows はwhere.exe npx)の出力をcommandに書きます。nvm / volta ではnodeも見つからないことがあるので、envに"PATH": "<which node のフォルダ>:/usr/bin:/bin"も足します(Node.js を更新するとパスが変わります)。ツールが表示されない:JSON の構文と再起動を確認します。
mcpServersのキー(サーバー名)は英数字にしてください(日本語だとツールが見つからないことがあります)。口座のツールが表示されない:
BITBANK_API_KEYとBITBANK_API_SECRETの両方を設定しているか確認します。タイムアウトする:ネットワークと bitbank API の状態 を確認します。
Cannot find package 'tsx':古い版(v0.1.0)の問題です。npx -y bitbank-lab-mcp@latestにします。チャートが表示されない:「identifier と title を追加して、アーティファクトとして表示して」と頼んでください。
当日の約定データが少ない:bitbank の仕様です。日ごとの約定履歴は UTC の 1 日が終わってから(日本時間 9:00 以降)公開されるので、当日分は直近の約 60 件しか取れません(結果に warning が出ます)。公開済みの期間は、
get_flow_metrics/analyze_volume_profileのsince/until(最大 7 日)で全件を集計できます。ログを見たい:
envに"LOG_LEVEL": "debug"を足して再起動します。MCP Inspector で試したい:
npx @modelcontextprotocol/inspector -- npx -y bitbank-lab-mcp
ドキュメント
バグ報告や要望は GitHub Issues へ。
免責事項
開発段階について
本ツールは開発段階(ベータ版)です。バグ、不具合、誤動作、または不正確な分析結果を含む可能性があります。
AI エージェントによる処理結果について
本MCPサーバー / 本CLIツール が提供するデータを AIエージェント等が処理・生成した結果について、正確性、完全性、有用性、最新性を保証するものではありません。AI エージェント等による処理の結果、注文種別、価格、数量その他の取引条件が利用者の意図と異なる形で処理または実行される可能性があります。
金融商品取引法上の位置づけ
本MCPサーバーは情報提供のみを目的として提供されるものであり、投資助言・代理業、投資勧誘、その他金融商品取引法上の行為を目的とするものではありません。
外部サービスへの依拠
本MCPサーバーは外部API、LLM、第三者サービス等に依拠して提供するものであり、これらの仕様変更、停止、不具合等が生じた場合には、本MCPサーバーが正常に動作しない可能性があります。
安全対策の補助性
本MCPサーバーに実装されている最終注文確認機能、バリデーションその他の安全対策は、誤操作または誤発注等を防止するための補助機能であり、その完全な防止を保証するものではありません。
利用者の責任
利用者は、本MCPサーバーにより提供・生成された情報および注文内容等を自身で十分に確認の上、自己の判断と責任において本MCPサーバーを利用し、投資判断、注文実行および取引を行うものとします。
損害の免責
当社は、本MCPサーバーの利用もしくは利用不能、または本MCPサーバーにより提供・生成された情報、AI エージェント等による処理結果もしくは取引操作に基づく投資判断・注文・取引等に関連して生じたいかなる損害についても、当社の故意または重過失による場合を除き、一切責任を負いません。
APIキー・認証情報の管理
APIキーおよび取引に必要なパスワード等は利用者自身の責任において適切に管理してください。チャット欄や公開リポジトリその他第三者が閲覧可能な環境等へ APIキーや取引パスワード等の認証情報等を入力・掲載しないよう十分ご注意ください。
利用者による認証情報等の管理不備、誤入力、漏えい、第三者利用等により生じたいかなる損害についても、当社の故意または重過失による場合を除き、当社は一切責任を負いません。
Available Tools
33 toolsanalyze_bb_snapshotA
[Bollinger Bands / BB / Squeeze] ボリンジャーバンド(BB / squeeze / bandwidth / zScore)の数値スナップショット。軽量・BB特化。zScore は σ 単位(±2 が上下のバンド)。
mode=default: ±2σ帯の基本情報 / mode=extended: ±1σ/±2σ/±3σの詳細分析。
⚠️ 最新値のみ。時系列チャート描画 → prepare_chart_data(indicators: ["BB"])。
Inputs: mode, pair, type, limit.
analyze_candle_patternsC
[Candlestick Patterns / Doji / Engulfing] ローソク足パターン検出(candle patterns / doji / engulfing / hammer / harami)。1〜3本足パターンを検出し文脈と過去統計を付けて解説。
Inputs: date, pair, as_of, patterns, +6 more.
analyze_currency_strengthA
[Currency Strength / Ranking / Screening] 通貨強弱ランキング(currency strength / relative strength / ranking / screening)。全JPYペアを複合スコア(変化率・RSI・SMA乖離・出来高)で判定。注目銘柄の発見・スクリーニングに。
Inputs: topN, type.
analyze_ema_snapshotA
[EMA / Exponential Moving Average] EMA(exponential moving average / trend / slope)の最新値・整列・クロス・傾きを返す(既定: 12/26/50/200)。
⚠️ 最新値のみ。時系列チャート描画 → prepare_chart_data(indicators: ["EMA_12","EMA_26"] 等)。
Inputs: pair, type, limit, periods.
analyze_fibonacciA
[Fibonacci / Retracement / Extension] フィボナッチ分析(fibonacci / retracement / extension / swing high-low)。スイング自動検出→リトレースメント/エクステンション水準を算出。過去の反応実績(反発率・リターン)付き。
複数タイムフレーム分析には analyze_mtf_fibonacci を使用。
Inputs: mode, pair, type, lookbackDays, +1 more.
analyze_ichimoku_snapshotA
[Ichimoku Cloud] 一目均衡表(Ichimoku / cloud / kumo / tenkan-kijun)の数値スナップショット。価格と雲の位置関係・転換線/基準線クロス・雲の傾きを数値で返す。
⚠️ 最新値のみ。時系列チャート描画 → prepare_chart_data(indicators: ["ICHIMOKU"])。
Inputs: pair, type, limit, lookback.
analyze_indicatorsA
[Technical Indicators / RSI / MACD / SMA] テクニカル指標の総合分析。最新値・トレンド判定・シグナルをテキストで返す。十分な limit を指定(例: 日足200本)。
描画 → prepare_chart_data / render_chart_svg。バックテスト → run_backtest。
Inputs: tz, date, pair, type, +1 more.
analyze_market_signalA
[Market Signal / Score / Triage] 市場の総合シグナル(market signal / composite score / bull-bear / triage)。5要素(板圧力・CVD・モメンタム・ボラティリティ・SMAトレンド)を-100〜+100の単一スコアで瞬時評価。分析の起点・スクリーニングに最適。
⚠️ 最新値スナップショットのみ。時系列チャート描画 → prepare_chart_data(indicators 指定)。
詳細分析には専門ツールを併用: get_flow_metrics / get_volatility_metrics / analyze_indicators / get_orderbook / detect_patterns。
Inputs: pair, type, windows, bucketMs, +1 more.
analyze_mtf_fibonacciC
[Multi-Timeframe Fibonacci / Confluence] 複数期間フィボナッチ一括分析(MTF fibonacci / confluence zone)。複数ルックバック期間の水準を並列計算し、コンフルエンス(合流)ゾーンを自動検出。analyze_fibonacci を個別に呼ぶ必要なし。
Inputs: pair, lookbackDays.
analyze_mtf_smaC
[Multi-Timeframe SMA / MTF] 複数タイムフレームSMA一括分析(multi-timeframe / MTF / SMA alignment / confluence)。整列方向とコンフルエンスを判定。
Inputs: pair, periods, timeframes.
analyze_sma_snapshotA
[SMA / Moving Average / Golden Cross] SMA(simple moving average / golden cross / dead cross)の数値スナップショット。最新値・クロス検出・整列状態(bullish/bearish/mixed)。periods は任意の周期を指定できる(既定: 25/75/200)。
⚠️ 最新値のみ。時系列チャート描画 → prepare_chart_data(indicators: ["SMA_25","SMA_75"] 等)。
Inputs: pair, type, limit, periods.
analyze_stoch_snapshotB
[Stochastic / Overbought / Oversold] Stochastic(stochastic / %K / %D / overbought / oversold / divergence)の最新状態。ゾーン・クロス・ダイバージェンスを判定。
⚠️ 最新値のみ。時系列チャート描画 → prepare_chart_data(indicators: ["STOCH"])。
Inputs: pair, type, limit, kPeriod, +2 more.
analyze_support_resistanceC
[Support / Resistance / Key Levels] サポート・レジスタンス(support / resistance / key levels / price levels)を自動検出。反発/反落ポイントの接触回数・強度・崩壊実績を分析。
Inputs: pair, topN, tolerance, lookbackDays.
analyze_volume_profileA
[Volume Profile / VWAP / POC] 出来高プロファイル分析(volume profile / VWAP / POC / value area)。VWAP±σバンド・価格帯別出来高・約定サイズ分布を算出。hours で期間指定(デフォルト4h、最大24h)。
期間指定の使い分け:
hours: 現在時刻起点の相対窓(最大24h)。
since / until: オフセット付き ISO8601 の絶対時刻区間(例: since=2026-08-01T00:00:00Z, until=2026-08-02T00:00:00Z)。過去の特定区間を全件集計する唯一の手段。until は排他([since, until))で省略時は現在時刻まで。最大 7 日。limit は適用しない。
hours と since/until は併用不可(併用すると user エラー)。since/until に YYYYMMDD 形式は使えない(暦日の基準がツール間で割れているため、絶対時刻はオフセット必須の ISO8601 のみ受け付ける)。
データソース制約(bitbank 側仕様): 約定アーカイブ /transactions/{YYYYMMDD} は UTC 暦日単位で、当該 UTC 日の完了後にのみ公開される。完了済み UTC 日は全件(1日あたり数千件)を集計に使う。進行中の UTC 日(JST 09:00 で切り替わる)は /transactions (latest, 直近約60件) のみ。
カバレッジ申告: params.timeRange は durationMin(先頭〜末尾のスパン)に加えて coveredMin(実データがある区間の合計)/ gapMin / segments を返す。欠損があれば meta.warning(取得層)と meta.warnings(計算層: 集計値がカバー区間のみ由来である旨)で明示される。
加工契約: 内部の約定列は timestampMs 昇順にソート済み。latest と date ベースのマージ時の重複除去キーは timestampMs:price:amount:side(transaction_id は使用しない)。
Inputs: tz, bins, pair, hours, +4 more.
detect_macd_crossB
[MACD Cross / Crossover / Screening] MACDクロス検出(MACD cross / crossover / golden cross / dead cross / screening)。
pair省略: 複数銘柄スクリーニング / pair指定: 単一ペア深掘り分析(forming検出・過去統計)。
screen(スクリーニング用):
crossType: golden|dead|both
minHistogramDelta / maxBarsAgo / minReturnPct / maxReturnPct
sortBy: date|histogram|return|barsAgo
limit: 上位N件
Inputs: pair, view, pairs, market, +7 more.
detect_patternsA
[Chart Patterns / Double Top / Head and Shoulders / Triangle] チャートパターン検出(chart patterns / double top / double bottom / head and shoulders / triangle / wedge / flag)。形成中+完成済みを統合検出。表示日時は tz(既定 Asia/Tokyo)で整形。
検出の意味論:
直近の一方向トレンド(上げ続け / 下げ続け)はパターンを構成しないため検出対象に入らない。「直近の値動きが結果に出ない」は多くの場合これであってデータ欠落ではない。実際に走査した範囲は meta.scan(content の「スキャン範囲」行)で確認すること。
ピボットの確定には前後 swingDepth 本が要るため、スキャン窓の両端 swingDepth 本はピボットにならない(swingDepth は時間足ごとに自動スケールする。例: 1hour の実効値は 3)。
limit はスキャン窓の本数であり、同時に「何が検出可能か」も決める。小さすぎる場合は data.warnings に limit_too_small_for_timeframe が載る(content 先頭にも警告行を出す)。
各検出器はパターンの大きさの下限をバー数で持つ。既定 limit(90)ではどの時間足・どの種別も到達可能だが、limit をこれより小さくすると特定の種別だけが静かに 0 件になることがある(下限の表は docs/tools.md の「limit の実効下限」)。
既定 limit(90)は形成中〜完成直後のパターンを見るための窓。過去のパターンの統計(data.statistics の成功率 / 平均リターン)や aftermath を調べるなら limit を上げる(上限 365)。summary / detailed の content 量はほぼ変わらず、増えるのは API 呼び出し回数。
date を指定すると、その tz の指定日終端以前を limit 本走査する。過去時点を再現する場合は、requireCurrentInPattern の「現在」も走査終端日に固定される。
検出が 0 件、または期待した種別が出ない理由を答えるときは view=debug を使う。候補ごとの棄却理由コードが candidates に載る(例: poor_trendline_fit / r2_below_threshold / neckline_above_pre_decline_high。コードの意味は docs/tools.md の「detect_patterns 詳細ガイド」)。
その理由を推測で説明しないこと。 「上昇局面だったので構造的に成立しない」のような一般的なテクニカル分析の知識からの説明は、もっともらしくてもツールの出力に基づいていない。debug の実出力(棄却理由コード、候補が 1 件も積まれていないという事実を含む)だけを根拠にする。
視覚確認: 結果の overlays を render_chart_svg に渡して描画可能。 描画結果は必ずビジュアルとしてレンダリングして表示すること。 チャット本文へのSVGコード直接出力は禁止。
構造化データ (data.patterns[*].range.start/end 等) は後方互換のため UTC ISO 文字列のまま。
Inputs: tz, date, pair, type, +12 more.
detect_whale_eventsC
[Whale / Large Orders / Big Players] 大口投資家の動向検出(whale / large orders / big players / smart money)。板×ローソク足で大口注文を簡易検出。推測ベース。
Inputs: pair, minSize, lookback.
get_candlesB
[Candles / OHLCV / Candlestick] ローソク足(candles / OHLCV / chart data)を取得。1min〜1monthの各時間足に対応。date は tz(既定 Asia/Tokyo)の暦日として解釈し、その終端以前の limit 本を返す。 詳細は inputSchema を参照。
【重要】バックテストには run_backtest を使用(データ取得〜チャート描画を一括実行)。
Inputs: pair (required), type (required), tz, date, +3 more.
get_flow_metricsA
[Flow / CVD / Buy-Sell Pressure] 資金フロー分析(flow / CVD / aggressor ratio / buy-sell pressure)。約定データからCVD・アグレッサー比・スパイクを検出。直近フローは hours(現在時刻起点)、過去の特定区間は since/until(絶対時刻)、件数指定は limit。
期間指定の使い分け:
hours: 現在時刻起点の相対窓(最大24h)。「直近N時間」の分析用。
since / until: オフセット付き ISO8601 の絶対時刻区間(例: since=2026-08-01T00:00:00Z, until=2026-08-02T00:00:00Z)。過去の特定区間を全件集計する唯一の手段。until は排他([since, until))で省略時は現在時刻まで。最大 7 日。limit は適用しない。
date: UTC 暦日 1 日(YYYYMMDD)。当該 UTC 日の全件(5,600〜8,000 件)を集計する。limit は適用しない。UTC 暦日ちょうどを指定する簡便手段なので、複数日にまたがる区間や UTC 暦日の境界に揃わない区間(例: JST の 1 日)には since/until を使うこと。
limit: date / hours / since・until のいずれも指定しない件数ベース取得(直近 N 件)でのみ有効(上限 2000 件 ≒ BTC/JPY で 6〜8.5 時間分)。区間指定と併用しても無視される。それより長い窓は件数ではなく hours / since・until で指定すること。
since/until は hours とも date とも併用不可(併用すると user エラー)。暗黙の優先順位を置くと、要求と異なる区間の集計値が無言で返るため。なお hours と date の同時指定だけは従来どおりエラーにせず hours が優先される(date は無視される)。
since/until に YYYYMMDD 形式は使えない。暦日の基準がツール間で割れている(本ツールの date は UTC 暦日、get_candles の date は tz 引数の暦日)ため、絶対時刻はオフセット必須の ISO8601 のみ受け付ける。
データソース制約(bitbank 側仕様): 約定アーカイブ /transactions/{YYYYMMDD} は UTC 暦日単位で、当該 UTC 日の完了後にのみ公開される。完了済み UTC 日は全件(1日あたり数千件)を集計に使う。進行中の UTC 日(JST 09:00 で切り替わる)の約定は /transactions (latest, 直近約60件) でしか取得できないため、当日区間のカバレッジは限定的(warning で明示される)。
カバレッジ申告: meta.actualRange は durationMinutes(先頭〜末尾のスパン)に加えて coveredMinutes(実データがある区間の合計)/ gapMinutes / gaps を返す。requestedMinutes(要求区間)に対する coveragePct が出るので、要求どおり取れたかは常にこの値で確認できる。欠損があれば meta.warning(取得層)と meta.warnings(計算層: 集計値がカバー区間のみ由来である旨)で明示される。完了済み UTC 日のみの区間なら coveragePct はほぼ 100%、進行中 UTC 日にかかる区間は latest 約60件ぶんまで下がる。
加工契約:
内部で使用する約定列は、取得パスに関わらず timestampMs 昇順にソート済み。
latest と date ベースをマージする場合、重複除去キーは
timestampMs:price:amount:side(transaction_id は使用しない: 同一約定でも上流エンドポイント間で ID が一致しないケースがあるため)。
Inputs: tz, date, pair, view, +7 more.
get_orderbookA
[Order Book / Depth / Spread] 板情報(order book / depth / bid-ask spread)の統合ツール。
【mode】summary(デフォルト): 上位N層+spread / pressure: 帯域別の買い/売り圧力 / statistics: 流動性ゾーン+大口注文 / raw: 生bids/asks+壁ゾーン推定。
Inputs: mode, pair, topN, ranges, +2 more.
get_tickerB
[Ticker / Price] 単一ペアのティッカー(ticker / price / 24h change)を取得。現在価格・出来高・24h高安。
Inputs: pair.
get_tickers_jpyB
[All Tickers / Market Overview] 全JPYペアのティッカー一覧(tickers / ranking / market overview)を取得。変化率・出来高でランキング表示可能。
Inputs: limit, order, sortBy, includeRanked.
get_transactionsA
[Transactions / Trades] 市場の約定履歴(transactions / recent trades)を取得。直近60件 or 日付指定。金額・価格でフィルタ可能(フィルタは limit の前に適用され、条件に合致した約定を最大 limit 件返す)。
limit による切り捨てが起きた場合は meta(totalFetched / matched / returned / truncated / actualRange / fetchedRange)と warning で明示される。
制約(bitbank 側仕様): date 指定(YYYYMMDD)は UTC 暦日アーカイブで、当該 UTC 日の完了後(JST 09:00 以降)にのみ公開される。進行中の UTC 日を指定すると 404。当日分の約定は date 省略(latest, 直近約60件)でのみ取得可能。
Inputs: date, pair, view, limit, +5 more.
get_ui_snapshotA
[Internal / MCP Apps] 確認 UI(iframe)向けに、直近の preview 系ツール応答のスナップショットを返す。 ホストがツール結果通知(ui/notifications/tool-result)を配信しない場合の UI 自己復元用。 LLM が会話の応答生成のために呼ぶ必要はない(preview 系ツールの応答に同じ内容が含まれる)。
Inputs: resource_uri (required), confirmation_token.
get_volatility_metricsB
[Volatility / ATR / RV] ボラティリティ指標(volatility / ATR / realized vol)を算出。RV・ATR・Parkinson・Garman-Klass・Rogers-Satchell。年率換算対応。aggregates.atr は Wilder ATR(RMA ベース、period=14、TradingView 標準と一致)。ローリングではボラ変化を RV / Parkinson で追跡してください。
Inputs: pair (required), type (required), tz, view, +5 more.
prepare_chart_dataA
[Chart / Candlestick / Visualization] チャート描画の第一選択ツール。
⚠️ limit はデフォルト 30 を推奨。ユーザーが期間を明示した場合のみ増やすこと。 indicators はユーザーが明示的に要求した指標のみ指定すること。分析のついでに追加しない。 indicators の同時指定はコンテキストを大幅に消費するため、必要最小限に留めること。
デフォルトはローソク足(OHLCV)のみ返す。indicators 未指定 = ローソク足のみ。 指標が必要な場合は indicators に明示指定: SMA_5, SMA_20, SMA_25, SMA_50, SMA_75, SMA_200, EMA_12, EMA_26, EMA_50, EMA_200, BB, ICHIMOKU, RSI, MACD, STOCH
レスポンス形式: { times[], labels?[], candles: [[o,h,l,c,v],...], series?: {指標名: values[]}, subPanels?: {...} } ローソク足は取引所の価格のまま。指標の値は価格の水準に合わせて丸め済み(10 万円以上は円の整数、安いペアほど小数の桁が増える)。全 null 系列は自動除外。
tz パラメータ(例: "Asia/Tokyo")指定時、times がローカル時刻に変換され、labels("03/16 17:00" 等の短縮表示文字列)も付加される。
SVG/PNG ファイル保存 → render_chart_svg。指標の最新値やトレンド判定 → analyze_indicators。
Inputs: tz, pair, type, limit, +1 more.
prepare_depth_dataA
[Depth Chart / Order Book / Visualization] 板の深度チャート描画の第一選択ツール。
getDepth(/depth API)を呼び出し、累積 volume の階段配列 ([price, cumulativeVolume][]) として返す。 Claude.ai の Visualizer 等クライアント側で描画可能な場合はこのツールを優先。 ファイル保存(SVG/PNG)が必要な場合は render_depth_svg を使用。
レスポンス形式: { bids: [[price, cumVolume], ...], asks: [[price, cumVolume], ...], bestBid, bestAsk, mid, spread, spreadPct, totalBidVolume, totalAskVolume, band: {pct, bidVolume, askVolume, ratio}, timestamp, isoTime }
bids は価格降順、asks は価格昇順
band は mid を中心とした ±bandPct 範囲の買い/売り量と比率(ratio = bidVolume / askVolume)
bids / asks / bestBid / bestAsk は取引所の価格のまま。mid と spread は丸め済み(10 万円以上は円の整数、安いペアほど小数の桁が増える)
Inputs: pair, levels, bandPct.
refresh_pairs_cacheA
[Maintenance / Fees] /spot/pairs 手数料レートの TTL キャッシュ(既定 1h)を強制再取得する。キャンペーン境界などで最新の maker/taker 手数料率を即時反映したいときに使う。引数なしで全ペアを再取得(pair 指定で対象ペアの率を強調表示)。
Inputs: pair.
render_candle_pattern_diagramA
[Candle Pattern Diagram / Education] ローソク足パターンの教育用構造図(candle pattern diagram / education / visualization)。analyze_candle_patterns の結果を初心者向けに視覚化。
ユーザーが「図で見せて」等と明示した場合のみ使用。自発的呼び出し禁止。data.svg を受け取ったら Visualizer(show_widget) の widget_code にそのまま渡してレンダリングすること。 チャット本文へのSVGコード直接出力は禁止。
Inputs: candles (required), theme, title, pattern.
render_chart_svgA
[SVG file / PNG save] ローソク足・ラインチャートをサーバー側で SVG/PNG に生成。 クライアント側で描画可能な場合は prepare_chart_data を優先。 ユーザーが SVG/PNG 保存を明示した場合のみ使用。自発的呼び出し禁止。 detect_patterns の overlays を渡してパターン描画可能。 オプションのインジケーター(SMA/EMA/BB/一目均衡表)はユーザーが明示的に要求した場合のみ指定すること。デフォルトではすべてオフ。
Inputs: tz, pair, type, depth, +18 more.
render_depth_svgA
[Depth Chart / Order Book Visualization] 板の深さチャートを SVG 生成(depth chart / order book visualization / bid-ask depth)。 クライアント側(Claude.ai の Visualizer 等)で描画可能な場合は prepare_depth_data を優先し、本ツールは SVG/PNG ファイル保存(preferFile / autoSave)やファイル埋め込み用途にフォールバックする位置づけ。 data.svg を HTML に埋め込んで表示。
Inputs: pair, type, depth, autoSave, +1 more.
run_backtestA
[Backtest / Strategy Test / SMA Cross / RSI / MACD] 汎用バックテスト(backtest / strategy test / simulation / performance)。データ取得〜計算〜チャート描画を一括実行。
戦略: sma_cross / rsi / macd_cross / bb_breakout。 期間: 1M / 3M / 6M / 1Y / 2Y / 3Y、または start_date+end_date (YYYY-MM-DD) で任意レンジ指定可。 時間軸: 1D / 4H / 1H。 SVG チャート付きで損益・勝率・最大DD・Sharpe Ratio 等を返却。 content テキスト末尾に equity_curve / drawdown_curve の JSON を含む (chartDetail=default は最大 200 点の均等サンプル、full は全点)。独自実装不要。
Inputs: strategy (required), pair, fee_bp, period, +8 more.
validate_candle_dataA
[Data Quality / Validation] OHLCVローソク足データの品質検証。 分析やバックテスト前に「このデータ信用できる?」を確認するためのツール。 完全性(歯抜け)・重複・OHLCV整合性・価格異常値・出来高異常値を検出し、0-100の品質スコア(A-F)を算出。 ペアの流動性ティア(major/mid/minor)を自動判定し、暗号資産のファットテール分布や低流動性ペアの出来高ゼロを考慮した適切なデフォルト閾値を適用。 閾値は price_sigma, volume_multiplier で手動調整も可能。
Inputs: tz, date, pair, type, +3 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 33 tools
There is meaningful overlap: analyze_indicators competes with the per-indicator snapshots (analyze_sma_snapshot / analyze_ema_snapshot / analyze_bb_snapshot / analyze_stoch_snapshot / analyze_ichimoku_snapshot), detect_macd_cross overlaps analyze_indicators and run_backtest's macd_cross strategy, and analyze_fibonacci overlaps analyze_mtf_fibonacci. The descriptions do mitigate this with explicit routing hints ('latest value only', 'use analyze_mtf_fibonacci instead', '詳細分析には専門ツールを併用'), so an agent can usually choose correctly, but it requires reading long descriptions.
Names are consistently snake_case and verb-first (get_*, analyze_*, detect_*, render_*, prepare_*, run_backtest, validate_candle_data, refresh_pairs_cache). Minor deviations: the awkward get_tickers_jpy suffix and a four-way verb split (get/analyze/detect/prepare-render) that is semantically reasonable but not a single uniform pattern.
33 tools exceeds a comfortable surface, and much of the excess comes from near-duplicative single-indicator snapshot tools plus paired prepare_*/render_* visualization tools. The domain is broad (market data, indicators, patterns, backtest, rendering), so it is not purely bloat, but the set could be consolidated substantially.
The analytics lifecycle is well covered: raw data (tickers, candles, orderbook, transactions), derived metrics (flow, volatility, volume profile), indicator/pattern analysis, backtesting, chart data/SVG rendering, and data quality validation plus cache maintenance. Gaps are minor and mostly out of scope for an analytics lab: no account/balance/order execution and no cross-pair candle screening beyond ranking helpers.
Maintenance
Related MCP Connectors
MCP server with quote and live cryptocurrency price tools, local and cloud-deployed transports.
Trading MCP server for AI agents, with live market data, account reads and controlled execution.
MCP server for OpenMM — exposes market data, account, trading, and strategy tools to AI agents
Unlock the power of real-time cryptocurrency data with our Crypto Price Insights MCP server.
Related MCP Servers
- AlicenseAqualityDmaintenanceAn MCP server that delivers cryptocurrency sentiment analysis to AI agents.547MIT

bitbank MCP Serverofficial
AlicenseAqualityFmaintenanceMCP server for bitbank cryptocurrency exchange enabling ticker, candlestick, order book, and transaction data retrieval.5MIT- AlicenseNot gradedqualityFmaintenanceAn MCP server that enables AI clients to analyze cryptocurrency market data from bitbank API, providing technical indicators, order book analysis, and chart visualization.MIT
- AlicenseDqualityDmaintenanceA powerful cryptocurrency analysis MCP server that adds advanced technical analysis capabilities to the original Binance MCP implementation.151Apache 2.0