bykaranteli

bykaranteli-mcp

リアルタイムの暗号資産デリバティブデータに対応する MCP（Model Context Protocol）サーバーです。資金調達率、取引所間の資金調達率アービトラージ、未決済建玉の偏り、清算、オプション、ETF 資金フロー、Fear & Greed、BTC ドミナンスを提供します。

bykaranteli.com の公開 JSON API を利用する、読み取り専用ツールとアカウントツールが計 68 個あります。マーケットデータツールは読み取りのみを行い、アラートとウォッチリストのツールは、ご自身のキーを使ってご自身のアカウントに対して動作します（アカウントツール（アラートとウォッチリスト））。2026-09-10 以降、API の利用にはアカウントキーが必要です。https://bykaranteli.com/dashboard/api で認証済みアカウントを作成すると無料キーを取得できます（1 分あたり 30 リクエスト、月あたり 15,000 リクエスト、公開深度）。Builder、Business、Scale プランでは、レート制限と月間のフェアユース上限が引き上げられ、メンバー向け深度（7 つの時間枠の LiqMap、5 分足の時系列データ）が利用可能になります。また、各プランの履歴期間内で、x402 カタログ呼び出しの月間枠が利用できます（プランと有料深度）。BYKARANTELI_API_KEY にキーを設定してください。データは Binance USDT-M 無期限先物を対象としています。資金調達率アービトラージ、清算、注文板の深度、オプション、ポジショニング、保険基金については、各ボードに記載された bykaranteli.com/coverage の他の取引所も対象です。

ホステッドエンドポイント（インストール不要）

https://mcp.bykaranteli.com を、MCP 対応アシスタントのカスタムコネクターとして設定してください。インストール不要で、同じツールを利用できます。各ツールの呼び出しにはアカウントキーが必要です（無料キーは https://bykaranteli.com/dashboard/api で取得できます）。接続とツールの一覧表示にはキーは必要ありません。キーは次のいずれかの方法で送信します。

• リクエストヘッダー x-api-key: bk_...（claude.ai のカスタムコネクター、Cursor、Claude Code）；
• リクエストヘッダー Authorization: Bearer bk_...；
• ヘッダーを送信できないクライアント（ChatGPT）では、アドレス https://mcp.bykaranteli.com/?key=bk_... を使用します。このアドレスはパスワードと同様に扱い、漏洩した場合はキーを無効にしてください。

また、クライアントで利用できる場合は OAuth 2.1 でサインインできます（claude.ai のカスタムコネクター：Authentication、Sign in；ChatGPT コネクター：OAuth）。クライアントが自身を登録し（RFC 7591、PKCE S256）、bykaranteli.com で一度承認すると、ご自身のアカウントキーで動作します。接続済みアプリは Data and API ページに表示されます。ディスカバリー： https://mcp.bykaranteli.com/.well-known/oauth-protected-resource。

無料アカウントでは、API とホステッド MCP の利用枠が月間の共通カウンターに計上されます。Builder 以上のプランでは、より高いレート制限とメンバー向け深度が利用できます。

初心者向けの手順ガイド：https://bykaranteli.com/guide/connect

クイックスタート

Claude Code

claude mcp add bykaranteli -e BYKARANTELI_API_KEY=bk_... -- npx -y bykaranteli-mcp

Claude Desktop

claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "bykaranteli": {
      "command": "npx",
      "args": ["-y", "bykaranteli-mcp"],
      "env": { "BYKARANTELI_API_KEY": "bk_..." }
    }
  }
}

Cursor／その他の MCP クライアント

stdio 対応の MCP クライアントであれば利用できます。コマンドは npx、引数は ["-y", "bykaranteli-mcp"]、環境変数は BYKARANTELI_API_KEY です。

Node.js 18 以降が必要です。

ツール

ツール	回答できる質問
get_market_indices	「今日のFear & Greed指数は？」「現在のBTCドミナンスは？」
get_funding_heatmap	「現在の資金調達率は？」「SOLの資金調達率は？」
get_funding_arbitrage	「資金調達率の裁定機会はありますか？」「キャリー目的でBTCをロング／ショートするなら、最適な取引所は？」
get_pressure_scores	「現在、過剰なレバレッジがかかっている、またはポジションが偏っているコインは？」
get_top_movers	「今日、OIが最も急増した銘柄は？」「現在、資金調達率が最も極端な銘柄は？」
get_liquidations	「今日はどれくらい清算されましたか？」「今週、ロングとショートのどちらが清算されましたか？」
get_liquidation_leaderboard	「今日、最大の清算は何でしたか？」「清算が集中するのはアジア時間と米国時間のどちらですか？」
get_insurance_funds	「Binanceの保険基金の規模は？」「今週、保険基金が縮小した取引所はありますか？」
get_tokenized_stocks	「オンチェーン上にトークン化されたTeslaはどれくらいありますか？」「実際の株価との乖離が最も大きいトークン化株は？」「このラッパーの供給量はどの価格で評価されましたか？」（price_source、totals.priced_by）
get_etf_flows	「昨日、Bitcoin ETFは買い越しでしたか、売り越しでしたか？」「ETH ETFの累積流入額は？」「今週のXRP ETFの資金フローは？」
get_cot_positioning	「ヘッジファンドはBitcoinをロングしていますか、ショートしていますか？」「COTレポートには何が示されていましたか？」
get_options_snapshot	「BTCのオプションの壁はどこですか？」「DVOL／ゼロガンマ水準は？」
get_coinbase_premium	「米国の投資家はBitcoinを買っていますか？」「ベーシストレードの収益率は？」
get_flow_toxicity	「有害な注文フローが増えていますか？」「現在のBTCのVPINは？」
get_options_flow	「大口のオプション投資家は何を買っていますか？」「今日はブロック取引がありましたか？」
get_slippage	「100万ドルの成行注文ではどれくらいスリッページが発生しますか？」「最も板が薄いのはどこですか？」
get_fomc_impact	「FOMCの日にBTCはどう動きますか？」「次回のFOMC会合はいつですか？」
get_liquidation_cascades	「あの急落の原因は何ですか？」「今週、誰が清算されましたか？」
get_open_interest	「市場にレバレッジが流入していますか？」「XRPでショートが積み上がっていますか？」
get_psi_charge	「市場はどのような流動性状態ですか？」「待機資金が動き始めていますか？」
get_theme_indices	「AI、RWA、DePIN、ミーム、L2、DeFiのうち、どの暗号資産ナラティブが優勢ですか？」
get_factor_board	「今日、通常とは異なる水準にある指標と、その後に過去どのような動きがあったかを教えてください。」
get_venue_markets	「取引所全体のBTC建玉は？」「無期限先物のOIに占めるDEXの割合は？」「どこかでUSDTがペッグを外れていますか？」
get_leverage_tiers	「BybitでSOLに設定できるレバレッジは？」「DOGEの最大レバレッジが最も高い取引所は？」「今週、コインのレバレッジを引き下げた取引所はありますか？」
get_withdrawal_status	「KuCoinはUSDTの出金を停止していますか？」「GateからUSDTを出金するのに最も安いネットワークは？」「現在、出金を停止している取引所は？」
get_venue_profile	「Bybitについて、どのような記録がありますか？」「OKXはいくつのコントラクトを上場していますか？」「HTXは稼働中ですか？今週、そこで何が起きましたか？」
get_settlements	「今週、何が満期を迎えますか？」「OKXの次のBTC四半期先物はいつですか？」「9月限先物はどの価格で決済されましたか？」
get_borrow_rates	「BinanceでUSDTを借りるコストは？」「ETHを借りるのに最も安い取引所は？」「ステーブルコインの借入が急増していますか？」
get_fee_table	「Bitgetの無期限先物の手数料は？」「テイカー手数料が最も低い取引所は？」「今週、手数料を変更した取引所はありますか？」
get_lead_lag	「CoinbaseとBinanceでは、どちらが先に動きますか？」
get_iv_surface	「満期別のBTCインプライドボラティリティは？」「下落への備え（スキュー）は割高ですか？」
get_whale_tape	「現在、クジラは買っていますか、売っていますか？」
get_correlations	「過去30日間で、SOLとBTCの相関はどれくらいですか？」
get_new_listings	「今週、どの無期限先物が上場しましたか？最初に上場したのはどこですか？」
get_macro_liquidity	「FRBのバランスシート／RRP／ステーブルコイン供給量はどう動いていますか？」
get_network_health	「現在のBitcoinのハッシュレート、難易度、手数料、メンプールの状況は？」
get_tradfi_board	「TSLA無期限先物の資金調達率は？」「NVDA無期限先物を上場している取引所は？」「株式市場の取引時間中ですか？」
get_rsi_heatmap	「日足で売られすぎのコインは？」「4時間足と週足のBTC RSIは？」
get_hl_whales	「HyperliquidのクジラはBTCをネットロングしていますか？」「最大規模の口座はたった今、どのようにポジションを反転させましたか？」
get_positioning	「BinanceのBTCロング／ショート比率は？」「大口トレーダーはETHをネットショートしていますか？」「今日のCVDは？」
get_coverage	「清算総額のデータ対象となっている取引所は？」「データはどれくらい新しいですか？」
get_orderbook_depth	「最大のBTC買い板の壁はどこですか？」「CoinbaseとBinanceで、ETH価格の2％以内の板の厚さはどれくらいですか？」
get_jupiter_perps	「JupiterのSOL無期限先物のロングOIとショートOIはそれぞれどれくらいですか？」「今週Jupiterで首位だったのは誰ですか？」「JLPのAPRは？」
get_solana_perps	「Solanaの無期限先物DEXで、建玉が最も多いのはどこですか？」「PacificaのBTC資金調達率と24時間取引高は？」「PhoenixのSOL建玉は？」「GM TradeとJupiterを比較すると？」
get_desk_notes	「今日、デスクはデリバティブデータから何を観測しましたか？」「10月14日に何が起きましたか？」「日付、数値、時刻を含む、引用可能な一文をください。」
get_turkey_premium	「リラでBitcoinを買う場合、世界価格よりどれくらい高くなりますか？」「現在のTurkey Premium Indexとそのスコアは？」「最も割高なトルコの取引所は？」「公式レートに対するUSDT/TRYのレートは？」
get_data_proof	「ByKaranteliの数値が後から変更されていないことを検証できますか？」「現在のBTC資金調達率のオンチェーン証明を表示してください。」「最新のエポックを確定したSolanaトランザクションは？」
get_cycle_indicators	「Pi Cycleはクロスしましたか？今日のMayer MultipleとPuellは？」
get_altseason	「アルトシーズンですか？」「アルトコインシーズン指数は？」
get_metric_context	「今日の資金調達率は、過去と比べて極端ですか？」「この数値は分布のどの位置にありますか？」
get_quantum_exposure	「量子コンピューターに脆弱なBitcoinはどれくらいありますか？」「P2PKのエクスポージャーは？」
get_liqmap	「BTCの清算クラスターはどこですか？」「レバレッジをかけたロングは、どこで清算されますか？」
get_market_profile	「今日のBTCのコントロールポイントはどこですか？」「昨日のバリューエリアは？」「まだ試されていないネイキッドPOCは？」
get_options_chain	「今日、BTCの建玉は権利行使価格別にどう動きましたか？」「ETHのATM IVは時間ごとにどう推移していますか？」「24時間で最も建玉が増えた満期は？」
get_hl_positions	「HyperliquidのクジラはBTCのどの価格で清算されますか？」「追跡対象の建玉のうち、価格より下にある想定元本はいくらですか？」「モデルは追跡対象のポジションと一致していますか？」
get_venue_share	「今週、最も清算が多かった取引所は？」「無期限先物の建玉は取引所別にどのように分かれていますか？」
get_tradfi_gaps	「週末にTSLA無期限先物はどう動きましたか？」「NVDAの月曜の寄り付きギャップはどれくらいでしたか？」「夜間、取引所間の価格差はどれくらいありましたか？」
get_series	「過去1週間のBTC建玉を時間別に教えてください。」「9月1日以降のOKXにおけるETH資金調達率は？」「今月の日次Coinbaseプレミアムは？」（指標リスト、単位、最小期間：https://bykaranteli.com/api/series/metrics）
すべての市場データの回答は JSON 形式で、generatedAt タイムスタンプ、人が読めるページへの source URL、source_page、api_path、回答自体の generated_at、fetched_at、回答に含まれる場合は数値の根拠となる venues、coverage（full、sampled、mixed のいずれか）、stale_venues、recorded_since、および proof ページ（https://bykaranteli.com/proof）を含む provenance ブロックが付いています。回答に含まれないフィールドは省略され、補完されることはありません。シンボルは BTCUSDT と BTC のどちらでも指定できます。

回答はモデルのコンテキストに収まるサイズになっています。引数なしの呼び出しでは、全データではなく、短い最初のページ（たとえば 30 行、または時系列の最新データポイント）が返されます。短縮されたリストはすべて、field、returned、total、more を含む trimmed に記載されます。残りを取得するパラメーターは symbol、coin、asset、limit、days、detail などです。フィルターを指定した呼び出しでは、詳細情報がすべて保持されます。回答は 100,000 文字が上限です。これを超える場合、ツールは呼び出しを絞り込む方法を示します。

アカウントツール（アラートとウォッチリスト）

これらのツールは、同じキーを使ってお客様自身の ByKaranteli アカウントを読み取り、変更します。対象となるのは、Telegram、メール、プッシュ通知、Webhook で通知するアラート設定とウォッチリストです。取引、資金の移動、他のアカウントへのアクセスは行いません。

ツール	機能
parse_alert_text	「BTC funding above 0.05%」や「tell me when ETH drops 5% in a day」といった文を、信頼度と、文面で指定されていない項目とともに、正確な設定に変換します。ルールベースで動作し、何も保存せず、しきい値を作り出すこともありません。
list_alert_recipes	条件、適用範囲、通知先、および各アラートが最後に発動した日時とともに、アラート設定の一覧を表示します。
create_alert_recipe	アラート設定を保存します（アカウントに書き込みます）。
delete_alert_recipe	ID を指定して、アラート設定を削除します（アカウントに書き込みます）。
list_watchlists	ウォッチリストと、それぞれに登録されているシンボルの一覧を表示します。
add_watchlist_symbol	シンボルを既定のリスト、または指定したリストに追加します（アカウントに書き込みます）。
remove_watchlist_symbol	シンボルをリストから削除します（アカウントに書き込みます）。
list_tracked_addresses	追跡している Hyperliquid アドレスと、それぞれの直近のポジションを一覧表示します（アカウントを読み取ります）。
add_tracked_address	ポジションアラートを受け取るため、Hyperliquid アドレスの追跡を開始します（アカウントに書き込みます。Terminal 以上が対象です）。
remove_tracked_address	アドレスの追跡を停止します（アカウントに書き込みます）。

• 書き込みを行うツールには readOnlyHint: false が設定されています（削除を行う 2 つのツールには destructiveHint: true も設定されています）。そのため、変更前の確認を求めるクライアントでは、確認が表示されます。
• アカウントで保持できる設定数はプランによって異なります。上限に達すると、create_alert_recipe は保存せずに上限を返します。
• すべての呼び出しは、他のリクエストと同様にキーのプランにカウントされます。書き込みにはキーごとのレート制限も適用され、各書き込みは実行に使われたキーとともにアカウントに記録されます。
• アラート設定とウォッチリストの変更は、https://bykaranteli.com/dashboard/alerts と https://bykaranteli.com/dashboard/watchlist にすぐ反映されます。
• ツールの呼び出しが 401 を返す場合、本文の error_description に送信すべき内容が記載され、x-byk-mcp-auth ヘッダーに原因が示されます。原因は key_required（認証情報がまったくない）、key_unusable（ヘッダーまたはアドレスにキーが含まれていない。bk_... プレースホルダー、未設定の変数、Bearer 以外のスキーム、形式が異なる OAuth トークンなど）、key_wrong_type（プリペイドの bk_live_ キー。/api/x402/* で呼び出しごとに支払いを行いますが、MCP は利用できません）、key_unrecognised（入力ミス、期限切れ、または取り消し済み）のいずれかです。OAuth サインインに対応しているクライアントでは、WWW-Authenticate チャレンジによってサインインが開始されます。このパッケージは REST の本文をそのまま転送するため、同じメッセージが stdio 経由でモデルに届きます。

設定

環境変数	デフォルト	用途
BYKARANTELI_API_KEY	なし	Authorization: Bearer として送信されるアカウントキー（bk_...）。https://bykaranteli.com/dashboard/api で無料で取得できます。2026-09-10 以降のプログラムでは必須です
BYKARANTELI_BASE_URL	https://bykaranteli.com	API ホストを上書きします（テスト専用）。このキーはここで指定したホストに送信されるため、信頼できるサーバーのみを指定してください。

データに関する注意事項

• シグナルエンジンは2026年9月に廃止されました。このサーバーが公開するのは記録された市場データのみで、取引シグナルやパフォーマンスに関する主張はありません。
• 資金調達、OI、圧力のデータは15〜30分ごとに更新され、指数は30分ごとに更新されます。
• ここにある情報は金融アドバイスではありません。bykaranteli.com/risk-guide をご覧ください。

開発

npm install
npm run build
node dist/index.js   # speaks MCP over stdio

バージョンごとのリリースノート：CHANGELOG.md。

ライセンス

サーバー：MIT。データ：個人利用および研究目的での利用は、帰属表示「ByKaranteli (bykaranteli.com)」を条件とします。商用利用にはBusinessプランが必要です。ライセンスの全文：https://bykaranteli.com/data#license。

プランと有料データの範囲

プラン	レート	月間	範囲
Free API	30 / 分	15,000	公開ページ
Terminal	60 / 分	150,000	公開ページ
Builder	300 / 分	1,000,000（公正利用）	メンバー向けデータ範囲、x402カタログ：過去90日間について月1,000回まで、1回あたり最大5,000行、要約系列のみ。生レコードのルートは1回ごとに有料
Business	1,200 / 分	3,000,000（公正利用）	メンバー向けデータ範囲、商用ライセンス、x402カタログ：過去365日間の生レコードを月10,000回まで含み、同じ期間の月次一括エクスポートも利用可能
Scale	3,000 / 分	10,000,000（公正利用）	メンバー向けデータ範囲、派生データの再配布、全アーカイブの生レコードを月間上限なしで利用できるx402カタログ、全アーカイブの月次一括エクスポート

価格：https://bykaranteli.com/pricing

FreeまたはTerminalのキーが月間上限を超えると、月がリセットされるまで429が返されます。有料キーは公正利用の上限を超えても停止されず、月がリセットされるまでFreeのレート（1分あたり30件）で応答し、すべての応答に x-quota-state: slow が付与されます。

全プランの表：https://bykaranteli.com/developers#tiers。ライブスナップショットを超える記録済みの履歴と生レコードについては、bykaranteli.com から匿名エージェント向けの従量課金制x402エンドポイントも利用できます（SolanaまたはBase上のUSDCで1回ごとに課金、アカウント不要）：https://bykaranteli.com/developers#x402 · マシン向けカタログ：https://bykaranteli.com/api/x402。Builder、Business、Scaleのキーは、プランのカタログ利用枠内でこれらのルートを無料で呼び出せます（上表を参照）。含まれる呼び出し1回は、月間公正利用枠のリクエスト10件分としてもカウントされます。プランに含まれない呼び出しでは x402_allowance_used、history_window、または raw_tier_required が返されます。また、プランで利用できないルートでは tier_required が返されます（一括エクスポートはBusiness以上のプランが対象です）。アカウントキーを Authorization: Bearer に設定したまま、プリペイドキーを x-api-key に設定して支払うか、ウォレットからアカウントキーなしで支払ってください。