Tradingcalc MCP

TradingCalc MCP Server

LLM はトレードの計算を推測します。このサーバーが計算します。同じ入力には常に同じ数値を返し、すべての結果には検証可能な署名が付与されます。また、コアの計算式は公開ベクトルと照合してテストされています（現在の件数は上のバッジをご覧ください）。

 Your question               MCP tool call                    Result
+------------------+      +---------------------------+      +---------------------------+
| "Risk $200 on    |   ►  | workflow.run_forex_       |   ►  | 0.67 lots, plus an ECDSA  |
|  EUR/USD with a  |      | position_size_live        |      | P-256 signature you can   |
|  30 pip stop"    |      | (deterministic maths)     |      | verify offline            |
+------------------+      +---------------------------+      +---------------------------+

Claude、Cursor、その他の MCP クライアントにトレードについて質問すると、推測ではなく正確な数値が返ってきます。

「権利行使価格が 9 万ドル、満期まで 30 日、インプライド・ボラティリティが 55％の BTC コールオプションはいくらですか？」 「30 ピップスの損切りで 200 ドルの損失リスクを取る場合、EUR/USD を何ロット取引すべきですか？」 「この月次リターン系列における 95％の Value at Risk はいくらですか？」 「0.5 BTC を 8 万ドルで買い、5 倍のレバレッジで 9 万 5 千ドルで売った場合の PnL はいくらですか？」

対応範囲（77 ツール）

分野	例
オプション	Black-Scholes の価格とグリークス（手動、または Deribit の BTC/ETH オプションとライブで照合）、ペイオフと損益分岐点、ストラドルとストラングル、バーティカル・スプレッド、カバードコールとプロテクティブプット、インプライド・ボラティリティ
外国為替	リスク額に基づくポジションサイズ、ピップ値、証拠金、スワップコスト、通貨換算、通貨ペアの相関、口座通貨のライブレートを使った計算
リスクと統計	VaR と CVaR、Lo の 2002 年補正を適用したシャープレシオ、Deflated Sharpe、ケリー・フロンティア、GARCH(1,1)、リスクパリティ、ハースト指数、共和分、ポートフォリオ・ティアシート、EVT テールリスク
予測市場	Kalshi、Polymarket、Limitless、Myriad におけるオッズと手数料、マーケットが示唆するオッズ、エッジに基づくサイズ計算、スプレッドと裁定取引のチェック
オンチェーン	Solana のトークンとウォレットのチェック、スワップの価格インパクト、pump.fun のボンディングカーブ、インパーマネントロス
暗号資産の現物取引	暗号資産を現物で売買した場合の損益（両方の手数料を差し引いた後）
暗号資産の先物取引	PnL、清算価格、損益分岐点、資金調達コスト、ポジションサイズ、リスクリワード、線形契約とコイン証拠金契約

MCP（Claude Desktop、Cursor、VS Code などのクライアント）または MCP エンドポイントへの通常の HTTP POST で利用できます。登録は不要です。サーバーはリモートなので、1 行のクライアント設定以外にインストールは必要ありません。以下の Claude Desktop ブリッジのみ、Node.js 18 以降が必要です。

エンドポイント

接続先	URL	認証
MCP	https://tradingcalc.io/api/mcp	Bearer は任意（無料）
エージェント向け／セットアップ	https://tradingcalc.io/for-agents	なし
API と MCP の完全なリファレンス	https://docs.tradingcalc.io/api	なし
検証証明	https://tradingcalc.io/verify	なし

MCP トランスポート：Streamable HTTP（MCP 仕様 2024-11-05）

クイックスタート

クライアントごとに、コマンドを 1 つ実行するか設定を 1 つ追加します。前提条件：MCP クライアント。Node.js 18 以降が必要なのは Claude Desktop ブリッジとスキルインストーラーのみです。アカウントも API キーも不要です。

クライアント	インストール
Claude Code	claude mcp add --transport http tradingcalc https://tradingcalc.io/api/mcp
Gemini CLI	gemini extensions install https://github.com/SKalinin909/tradingcalc-mcp
スキル対応のコーディングエージェント（Claude Code、Cursor、Copilot）	npx skills add SKalinin909/tradingcalc-mcp
Claude Desktop、Cursor、VS Code	以下の設定を追加
その他のクライアント	通常の HTTP POST を使用します。下の「直接 HTTP」をご覧ください

Claude Desktop

claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "tradingcalc": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://tradingcalc.io/api/mcp"]
    }
  }
}

Cursor / VS Code

{
  "tradingcalc": {
    "url": "https://tradingcalc.io/api/mcp"
  }
}

エージェントスキル

skills.sh エコシステム（Claude Code、Cursor、GitHub Copilot など）に対応するコーディングエージェント向けです。エージェントがトレードの計算を自分で推測するのではなく、これらのツールをいつ使うべきかを教える SKILL.md をインストールします。

npx skills add SKalinin909/tradingcalc-mcp

直接 HTTP

curl -X POST https://tradingcalc.io/api/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "workflow.run_liquidation_safety",
      "arguments": {
        "side": "long",
        "entryPrice": 95000,
        "leverage": 10
      }
    }
  }'

プロンプトの例

接続後は、自然な言葉で質問するだけです。AI が適切なツールを自動的に選びます。

オプションのペイオフ

「BTC のコールオプションは、価格が 90,000 ドルの場合にどのようなペイオフになりますか？権利行使価格は 85,000 ドル、プレミアムは 0.02 BTC、1 契約をロングしています。」

ブラック・ショールズ／IV の確認

「Deribit の BTC-27FEB27-90000-C は、現在適正価格ですか？」

カバードコールの利回り

「80,000 ドルで購入した BTC を保有しています。30 日後満期の、権利行使価格 85,000 ドルのコールを 0.02 BTC で売ると、年率換算利回りはいくらですか？」

外国為替のピップ価値

「USD 建て口座で EUR/USD を 2 ロット取引した場合、1 ピップの価値はいくらですか？」

外国為替のポジションサイズ

「EUR/USD で 30 ピップの損切りを設定し、200 ドルのリスクを取るには、何ロット取引すればよいですか？」

外国為替の証拠金維持率

「有効証拠金が 5,000 ドル、使用中の証拠金が 1,800 ドルです。マージンコールまでどのくらいですか？」

バリュー・アット・リスク

「この月次リターン系列の 95％バリュー・アット・リスクと期待ショートフォールはいくらですか？［リターンを貼り付け］」

シャープレシオ

「この月次リターンの自己相関を調整したシャープレシオはいくらですか？」

共和分

「この 2 つの価格系列は共和分していますか？ペアトレードの機会はありますか？」

オッズ換算

「確率 35％は、どのオッズになりますか？」

市場が織り込むオッズ

「市場は、年末までに BTC がいくらになると予想していますか？」

予測市場の優位性

「このイベントが起こる確率は 60％だと思いますが、市場価格は 40％です。賭けるべきですか？資金が 1 万ドルなら、いくら賭けるべきですか？」

トークンの安全性チェック

「この Solana トークンはラグプルのリスクがありますか？Mint：DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263」

スワップの価格インパクト

「50,000,000 BONK を USDC にスワップすると、スリッページはいくらになりますか？」

ボンディングカーブ

「すでに 20 SOL を調達した pump.fun のカーブで、1 SOL で購入すると何トークン手に入りますか？」

時価総額の比較

「BONK に 1,000 ドルを投資し、時価総額が JUP と同じになった場合、その価値はいくらですか？」

ウォレットのフラグ確認

「このウォレットアドレスには、何らかのフラグが立っていますか？［アドレス］」（Solana または EVM）

取引損益

「BTC を 80,000 ドルで 0.5 BTC 購入し、レバレッジ 5 倍で 95,000 ドルで売りたいです。手数料差し引き後の純利益はいくらですか？」

ポジションサイジング

「口座資金は 10,000 ドルで、BTC を 83,000 ドルでロングし、81,000 ドルに損切りを設定して 1％のリスクを取りたいです。何 BTC 購入すべきですか？」

清算価格の確認

「ETH を 3,200 ドルでレバレッジ 10 倍でロングしています。どの価格で清算されますか？」

取引前の総合チェック

「この取引計画を分析してください。BTC を 83,000 ドルでロング、損切り 81,000 ドル、目標価格 90,000 ドル、口座資金 1 万ドル、リスク 1％、レバレッジ 5 倍です。実行する価値はありますか？」

ファンディングコスト

「Bybit で BTC を 83,000 ドルで 0.5 BTC ロングし、ファンディングレートが 0.01％です。3 日間でファンディングにいくらかかりますか？」

キャリートレード

「このキャリートレードは割に合いますか？Bybit でファンディング 0.01％のロング、Binance で 0.05％のショート、名目元本 5 万ドル、期間 30 日です。」

DCA の平均取得価格

「BTC を 78,000 ドルで 0.2 BTC、80,000 ドルで 0.3 BTC、82,000 ドルで 0.1 BTC 購入しました。平均取得価格と損益分岐点はいくらですか？」

段階的な利確計画

「BTC を 80,000 ドルで 1 BTC ロングしています。88,000 ドルで 30％、92,000 ドルで 40％、96,000 ドルで 30％を決済したいです。合計損益はいくらですか？」

---

ツール（77）

ツールの命名規則は、workflow.run_*／primitive.*／system.* の名前空間規約に従います。 従来のフラットな名前（pnl、liquidation など）も、後方互換性のために利用できます。すべてのツールは MCP 経由で無料で利用でき、登録も不要です。匿名では1日100回、無料の API キーを使用すると1日200回呼び出せます。

カテゴリ	ツール
オプション（Deribit BTC/ETH、コイン決済）	オプションのペイオフと損益分岐点、Black-Scholes 価格／グリークス（手動＋ライブ）、ストラドル／ストラングル、バーティカルスプレッドとアイアンコンドル、カバードコール／プロテクティブプット、インプライドボラティリティのソルバー（7）
外国為替（建値通貨＋ライブ口座通貨換算）	ピップ値、証拠金維持率、損益分岐点、損益、リスク／リワード、シナリオ、平均エントリー、ポジションサイズ、必要証拠金、通貨換算、スワップ／ロールオーバーコスト、相関／ヘッジ比率：手動版＋ライブ為替レート版（17）
リスク／統計	VaR/CVaR（＋修正 VaR）、シャープレシオ（Lo 2002＋PSR）、ハースト指数、共和分、ポートフォリオティアシート、GARCH(1,1)、リスクパリティ、デフレーテッドシャープレシオ、ケリー成長・安全性フロンティア、リターンの平滑化解除、EVT テールリスク、オーダーブックのインパクト（12）
予測市場（Kalshi、Polymarket、Limitless、Myriad、ADI Predictstreet の暗号資産カテゴリ）	オッズ換算、マーケットインプライドオッズ、予測市場のエッジ、期間別公正価値、複数取引所のスプレッド読み取り、複数取引所間の裁定取引（6）
オンチェーン（Solana＋5つの EVM チェーン、ツールごと）	トークンリスクチェック、スワップ価格へのインパクト、ボンディングカーブ、時価総額の比較、ウォレットのフラグチェック、インパーマネントロス（手動＋ライブ）（7）
取引計画	損益、損益分岐点、決済目標、シナリオ、DCA エントリー、段階的な決済、買い下がり（7）
リスクと証拠金	清算安全性、ポジションサイジング、最大レバレッジ、リスク／リワード（4）
資金調達とキャリー	資金調達コスト、資金調達アービトラージ、複利資金調達、資金調達の損益分岐点、キャリートレード（5）
市場構造（マーケットプロファイル）	寄り付き分析、セッション構造、バリューの移動、ブレイクアウトの定着（4）
プリミティブ	平均エントリー、ヘッジ比率（2）
暗号資産現物	暗号資産の利益：現物取引における両方の手数料を差し引いた後の利益または損失（1）
取引所間	価格コンセンサス：無期限先物価格が7つの基準取引所からどれだけ離れているか（1）
統合判断	取引前チェック（サイジング＋清算＋損益分岐点＋資金調達＋1回の呼び出しでの取引可否判断）、ポートフォリオリスクレビュー（2）
システム	system.verify - 正規テストベクトルを実行して合否レポートを取得します。system.pubkey - 署名付きレスポンスをオフラインで検証するための公開鍵を取得します（2）

ツールごとの完全なリファレンス（すべての入出力スキーマ、リクエスト／レスポンスの例、ツールごとの説明）：docs.tradingcalc.io/api

17の取引所にわたって統一された計算式：Binance, OKX, Bybit, Aster, Hyperliquid, MEXC, KuCoin, Gate, Deribit, Kraken, HTX, WOO, Phemex, Blofin, Backpack, dYdX, Polymarket Perps。

レート制限

アクセス	1日あたりのリクエスト数	料金
匿名	100	無料
無料の API キー	200	無料

本サービスは無料です。より高い上限のキーが必要ですか？[email protected] までメールでお問い合わせください。

キーは次のように渡します：Authorization: Bearer <your-api-key>

自己検証

エージェントは、結果を信頼する前にすべての正規テストベクトルを検証できます：

{
  "jsonrpc": "2.0", "id": 1,
  "method": "tools/call",
  "params": { "name": "system.verify", "arguments": {} }
}

レスポンス：{ "status": "pass", "passed": N, "failed": 0, "total": N }。N は現在の正規ベクトル数です（最新の数はページ上部のバッジに表示されます）。

ライブ検証：tradingcalc.io/verify

署名付きレスポンス

system.verify は計算式が正しいことを証明します。しかし、取得した特定のレスポンスが、途中のプロキシ、キャッシュ、または MITM によって改ざんされていないことまでは証明しません。すべての tools/call の結果には、ECDSA P-256 で署名された 2 つ目の content ブロックと、X-TradingCalc-Signature/Kid/Signed-At ヘッダーが含まれます。system.pubkey（または GET /api/mcp/pubkey）を呼び出すと、公開鍵（PEM + JWK）と、コールバック不要でオフライン検証するために必要な正規文字列の形式を取得できます。

1 日に 1 回、検証状態にも署名が付与され、その SHA-256 が Solana メインネットに Memo トランザクション（tcalc1 {date} {hash}）として書き込まれます。各レコードには前日のハッシュが含まれます。レコードは GET https://tradingcalc.io/api/anchors で確認できます。最新のレコードと、自分で検証する方法については、tradingcalc.io/verification をご覧ください。

使用例

• オプション・外国為替取引デスク：オプションの価格設定、外国為替ポジションの規模設定、または証拠金水準の確認を、1 回の正確な呼び出しで行えます
• クオンツリサーチ：リターン系列からシャープレシオ、VaR、共和分、ドローダウンの統計を算出し、参照ライブラリと照合します
• トレーディングボット：各取引の前に清算価格を確認します
• AI エージェント：ハルシネーションのリスクなしで、決定論的なリスク計算を実行できます
• マルチエージェントシステム：アナリスト + リスク + 執行のパイプラインに、リスク管理エージェントをそのまま組み込めます
• ダッシュボード：計算をプログラムから組み込めます

なぜ決定論的なのか？

LLM に直接質問すると、もっともらしくても誤っている可能性のある数値が返されます。TradingCalc MCP は正確な計算結果を返します。同じ入力には常に同じ出力が返されます。金融データに関するハルシネーションのリスクはありません。

リスクエージェントラッパー

examples/risk-agent-wrapper.ts：リスク判定を介した取引執行にそのまま使える TypeScript ラッパーです。 あらゆるエージェントフレームワーク（ElizaOS、CrewAI、AutoGen、Hummingbot、Freqtrade）と連携できます。

import { RiskAgent, preTradeGate } from './examples/risk-agent-wrapper';

const agent = new RiskAgent({ apiKey: 'tc_your_key', minLiqDistancePct: 3.0 });

const result = await agent.evaluate({
  symbol: 'BTCUSDT', exchange: 'bybit',
  side: 'long', entry_price: 83000, stop_loss: 81000,
  account_balance: 10000, risk_pct: 1, leverage: 5,
  funding_rate: 0.0001, hold_hours: 24,
});

if (result.approved) {
  // execute trade: result.recommended_size, result.liquidation_price
} else {
  console.log('Rejected:', result.rejection_reason);
}

// Binary gate for execution bots
const ok = await agent.isSafe({ symbol: 'ETHUSDT', side: 'short', ... });

// Standalone function (minimal integration)
const { approved, size, liqPrice } = await preTradeGate({ ... }, 'tc_your_key');

TypeScript SDK

コード中心の統合には、生の JSON-RPC の代わりに tradingcalc-sdk を使用してください。

npm install tradingcalc-sdk

import { TradingCalcClient } from 'tradingcalc-sdk';

const tc = new TradingCalcClient({ apiKey: 'tc_your_key' });

// Workflows: orchestrated decisions
const check = await tc.workflows.preTradeCheck({ side: 'long', entry_price: 83000, leverage: 5, funding_rate: 0.0001, account_balance: 5000 });

// Primitives: single formula
const avg = await tc.primitives.averageEntry({ symbol: 'BTCUSDT', input: { fills: [{ price: 83000, quantity: 0.1 }] } });

// System
const report = await tc.system.verify();

生の MCP アクセスには tc.call() を利用できます。詳しいドキュメントは npmjs.com/package/tradingcalc-sdk をご覧ください。

リンク

• エージェント向け：tradingcalc.io/for-agents
• 詳細なドキュメント（API と MCP のリファレンス、方法論、アーキテクチャ、変更履歴）：docs.tradingcalc.io
• 検証証明：tradingcalc.io/verify
• Web 計算ツール：tradingcalc.io