AlgoVesta MCP Trading

---

AlgoVesta は、ホスト型の Model Context Protocol サーバーを運用しており、単一の HTTPS エンドポイントを通じて16 の暗号資産取引所と MetaTrader 5に接続します。Claude、ChatGPT、Cursor、Claude Code、Gemini CLI など、MCP 対応クライアントであれば、残高の確認、ポジションのオープンとクローズ、ストップロスとテイクプロフィットの変更、自身の操作の監査ができます。

お客様のリスクルールは JSON にコンパイルされ、モデルからリクエストが送信された後、サーバー上で評価されます。つまり、モデルが何を言うよう説得されても、その影響を受けません。新しいキーはすべて、5,000 ドルのペーパー残高から開始し、各操作は ed25519 署名付きのハッシュチェーン形式のレシートを返します。

**ホスト型で、クローズドソースです。**このリポジトリは、公開ドキュメント、ツールリファレンス、クライアント設定一式です。インストール、ビルド、セルフホストは不要です。ホスト型エンドポイントに接続するだけです。

目次 — 概要 · 仕組み · クイックスタート · クライアントの接続 · 対応 AI クライアント · 利用イメージ · ツール · 安全性モデル · 取引所 · パフォーマンスと制限 · エンドポイント · FAQ

概要

トランスポート	Streamable HTTP によるリモート MCP
認証	シークレットリンク、または PKCE（S256）必須の OAuth 2.1 と Dynamic Client Registration（RFC 7591）
ツール	20 個 — 読み取り専用 13 個、書き込み 3 個、破壊的操作 4 個（リファレンス）
取引所	暗号資産取引所 16 社 · MetaTrader 5 · 組み込みペーパーエンジン
デフォルトのスコープ	paper — 仮想残高 5,000 ドル、ツールセットは同一
ライブスコープ	2 つ目の要素による認証後にのみ発行され、サーバー側で適用
リスクポリシー	JSON にコンパイルされ、サーバー上で決定論的に評価
監査	操作ごとに ed25519 署名付きのハッシュチェーン形式のレシートを発行。個別に検証可能
インストール	不要。ホスト型エンドポイントを使用します。
レジストリ	com.algovesta/trading — server.json がそのマニフェストです

仕組み

flowchart LR
    A["AI client<br/>Claude, ChatGPT, Cursor, and more"]
    B["AlgoVesta MCP server<br/>scope, rate limit, idempotency"]
    C{"Policy wall<br/>evaluated server-side"}
    R["Refusal<br/>plus audit entry"]
    D["Execution"]
    E["16 crypto exchanges"]
    F["MetaTrader 5<br/>managed terminals"]
    G["Paper engine<br/>5,000 USD virtual"]
    H["ed25519-signed receipt"]

    A -->|MCP over HTTPS| B
    B --> C
    C -->|violates a rule| R
    C -->|allowed| D
    D --> E
    D --> F
    D --> G
    D --> H

モデルは呼び出し元であり、権限を持つ主体ではありません。何をリクエストするかはモデルが決め、何が実行されるかはサーバーが決めます。お客様の取引所 API キーが AlgoVesta の外に出ることはなく、出金権限なしで作成されます。アシスタントが保持するのは、スコープが限定された取り消し可能な MCP リンクだけです。

クイックスタート

1. AlgoVesta アカウントを作成し、パネルの MCP Connection タブを開きます。
2. キーを生成します。新しいキーのスコープはデフォルトで paper です。完全なリンクは一度だけ表示されます。
3. そのリンクをカスタム MCP サーバーとして AI クライアントに貼り付けます。

https://api.algovesta.com/u/avmcp_<your-key>/mcp

この URL は認証情報です。 パスワードと同じように取り扱ってください。漏えいした場合は、パネルで無効化してください。無効化は新しい接続に対して直ちに有効になり、開いているイベントストリームは数秒以内に切断されます。

完全な認証フローを使用するクライアントでは、代わりに https://api.algovesta.com/mcp で OAuth 2.1 を使用できます。PKCE（S256）は必須で、Dynamic Client Registration に対応しているため、ほとんどのクライアントは自動的に設定されます。docs/AUTHENTICATION.md を参照してください。

クライアントを接続する

以下に 6 つの手順を紹介します。それ以外のクライアントでは、リモート MCP サーバーとして指定するフィールドに同じ URL を入力します。

Claude — ウェブ、デスクトップ、iOS、Android

Settings -> Connectors -> Add custom connector を開き、URL を貼り付けて、Claude から求められたらツールを許可します。手順

Claude Code

claude mcp add --transport http algovesta https://api.algovesta.com/u/avmcp_<your-key>/mcp

手順

ChatGPT

Settings -> Connectors -> Advanced -> Developer mode -> Create を開き、トランスポートに Streamable HTTP を選択します。カスタムコネクターは OpenAI 側の有料プラン向け機能です。手順

Cursor

~/.cursor/mcp.json、またはプロジェクト内の .cursor/mcp.json — ファイル

{
  "mcpServers": {
    "algovesta": { "url": "https://api.algovesta.com/u/avmcp_<your-key>/mcp" }
  }
}

VS Code — GitHub Copilot

.vscode/mcp.json — ファイル

{
  "servers": {
    "algovesta": {
      "type": "http",
      "url": "https://api.algovesta.com/u/avmcp_<your-key>/mcp"
    }
  }
}

Gemini CLI

~/.gemini/settings.json — ファイル。CLI のみ対応しています。Gemini のウェブアプリではカスタム MCP サーバーを受け付けません。

{
  "mcpServers": {
    "algovesta": { "httpUrl": "https://api.algovesta.com/u/avmcp_<your-key>/mcp" }
  }
}

その他

よく使用される 3 種類の設定形式と、curl による接続確認については、examples/other-clients.md を参照してください。

対応している AI クライアント

これは Streamable HTTP 経由の標準的なリモート MCP サーバーなので、リモート MCP に対応しているものであれば接続できます。以下のクライアントは、それぞれのドキュメントで対応状況を公開しています。各行のリンク先はクライアント独自の設定ドキュメントで、正確なフィールド名を確認できます。

アシスタントおよびチャットアプリ — 8

クライアント	MCP のドキュメント
Claude — ウェブ、デスクトップ、iOS、Android	カスタムコネクター
ChatGPT — 開発者モードのコネクター	OpenAI MCP docs
Microsoft Copilot Studio エージェント	MCP による拡張
Goose (Block)	block.github.io/goose
LibreChat	LibreChat の MCP
Open WebUI	docs.openwebui.com
Cherry Studio	docs.cherry-ai.com
Raycast	raycast.com

コーディングエージェントおよび IDE — 19

クライアント	MCP のドキュメント
Claude Code	Claude Code MCP
OpenAI Codex CLI	Codex MCP
Gemini CLI	Gemini CLI の MCP サーバー
Cursor	Cursor MCP
VS Code — GitHub Copilot	VS Code の MCP サーバー
Windsurf	Cascade MCP
Zed	Zed MCP
Cline	リモートサーバーへの接続
Roo Code	Roo で MCP を使う
Kilo Code	Kilo Code で MCP を使う
Continue	MCP の詳細解説
JetBrains AI Assistant	JetBrains IDE での MCP
Warp	Warp MCP
Amazon Q Developer	Amazon Q での MCP
Kiro (AWS)	Kiro MCP
Sourcegraph Amp	Amp マニュアル
Trae	Trae MCP
PostHog Code	posthog.com/code
Archestra.AI	archestra.ai

フレームワーク、自動化および開発者ツール — 6

クライアント	MCP のドキュメント
OpenAI Agents SDK	Agents SDK の MCP
fast-agent	evalstate/fast-agent
n8n — MCP クライアントツールノード	docs.n8n.io
Postman	MCP リクエスト
MCP Inspector	modelcontextprotocol/inspector
MCPJam	mcpjam.com

この主張の範囲。 このサーバーで Claude の動作を最初から最後まで検証済みです。ほかのクライアントは、リモート MCP に対応していることをドキュメントで公開しているため掲載しています。個別にテストしたという意味ではありません。クライアントの対応状況は急速に変化します。また、クライアントによってはコネクターの利用に有料プランが必要な場合（ChatGPT が該当）や、CLI でのみ利用できる場合（Gemini のウェブアプリではカスタム MCP サーバーを受け付けません）があります。掲載したクライアントで問題が起きた場合や、掲載されていないクライアントがある場合は、イシューを作成してください。

使用例

ツール名を指定して呼び出すことはありません。平易な言葉で尋ねると、アシスタントが適切なツールを選びます。

あなたの発言	アシスタントが使用するツール
「今、各口座にはいくらありますか？ 今月の成績はどうですか？」	get_portfolio_context — すべての取引所、MT5 アカウント、ペーパーブックの情報を一度に取得 — 続けて get_trade_history
「接続した取引所で、BTC はいくらで取引されていますか？」	compare_venues — 実測価格と、公表されている場合はビッド／アスクスプレッド
「Binance で 0.05 BTC のロングポジションを、損切り 2% で建てたら、いくらかかりますか？ また、自分のルールに違反しませんか？」	simulate_order — ポリシーの判定も含むドライラン
「では、注文してください。損切りは 2% 下、利確目標は 4% 上です。」	place_order
「ETH のポジションの損切りを建値まで上げてください。」	modify_position
「SOL のロングポジションを半分決済してください。」	close_position — 暗号資産では部分決済、MT5 では全決済
「1 回の取引でリスクを 1% 以下にし、ポジションは最大 3 つ、1 日のドローダウンが 5% に達したら停止してください。」	compile_policy — 承認用の読みやすい JSON を返します
「直近の注文の控えを表示して、検証してください。」	verify_receipt — 自分で取得できる公開鍵を使って、署名とハッシュチェーンを検証します
「リスク上限を 1% にして、過去 90 日分のシグナルをもう一度実行してください。」	simulate_policy、続けて get_job_status

また、拒否するリクエストもあります。 「この戦略の自動取引を有効にして」 — 拒否されます。auto_trade はどのスコープでも書き込み可能なフィールドではありません。Kraken に接続していない状態で 「Kraken で取引して」 — 推測で応じるのではなく、VENUE_NOT_CONNECTED を返します。「損切りなしで注文して」 — 拒否されます。代わりに適用できる保存済みのデフォルト値もありません。

paper キーでは、これらの処理はすべて、同じツールセットを使って 5,000 ドルの仮想残高で実行されるため、実資金を使わずにワークフロー全体をリハーサルできます。

ツール

20 個のツールがあります。read スコープはすべてのキーで使用でき、その他の機能は paper／live が有効化します。

ツール一覧

ツール	スコープ	種類	目的
get_portfolio_context	read	読み取り専用	接続されているすべての口座を 1 回の呼び出しで取得
get_market_price	read	読み取り専用	鮮度の報告を含むリアルタイム価格
get_trade_history	read	読み取り専用	暗号資産、MT5、paper の決済済み取引とパフォーマンス
compare_venues	read	読み取り専用	実測価格とスプレッドに基づき、接続済みの取引所を順位付け
simulate_order	read	読み取り専用	ポリシー判定を含むドライラン
place_order	paper / live	破壊的	ポジションを建てます（live の暗号資産では成行注文のみ）
compile_policy	read	読み取り専用	平易な言葉で書かれたルールをポリシーのプレビューに変換
list_open_orders	read	読み取り専用	保留中の指値注文（paper の注文板）
cancel_order	paper / live	破壊的	保留中の注文をキャンセル
close_position	paper / live	破壊的	全額または一部を決済（MT5 では全額決済のみ）
modify_position	paper / live	書き込み	損切りと利確を変更
list_strategies	read	読み取り専用	TradingView のストラテジーと、実資金取引が有効かどうか
create_strategy	paper / live	書き込み	新しいストラテジーを作成します。実資金取引は常に OFF で作成されます
update_strategy	paper / live	書き込み	ストラテジー設定を変更します（auto_trade は変更できません）
verify_receipt	read	読み取り専用	署名とハッシュチェーンを検証
replay_channel	read	読み取り専用	Telegram チャンネルをルールに照らしてバックテスト
backtest_my_signals	read	読み取り専用	異なる設定で過去の自分のシグナルを再生（キューに登録されるジョブ）
simulate_policy	read	読み取り専用	実際に決済した取引にリスクポリシーを適用（キューに登録されるジョブ）
import_tradingview_backtest	read	読み取り専用	TradingView の取引エクスポートを、実際の手数料とスリッページを使って再計算（キューに登録されるジョブ）
get_job_status	read	読み取り専用	キューに登録されたジョブの進捗と結果

2 つのツールについては、行わないことこそが重要なため、補足します。

• compare_venues は注文をルーティングしません。 リアルタイム価格と、公開している取引所については買値／売値のスプレッドを報告します。手数料のランク、注文板の厚さ、発生するスリッページは把握できず、そのことをすべての応答で明示します。買値／売値を公開していない取引所は、スプレッドがゼロであるかのように順位付けせず、別に表示されます。place_order では、引き続き自分で取引所を指定します。
• create_strategy／update_strategy で実資金取引を有効にすることはできません。 新しいストラテジーは常に auto_trade が OFF の状態で作成され、auto_trade は書き込み可能なフィールドに含まれていません。アシスタントは、どのように依頼されたり説得されたりしても、この設定を変更できません。単発の注文は確認できる 1 つのアクションですが、ストラテジーは会話が終わった後も取引を続けるため、有効化するかどうかはパネル上で人間が判断します。同じ理由で、シグナルの送信元を検証する第 2 要素である ip_allowlist の設定も拒否されます。

説明と JSON Schema を含む完全なリファレンス：docs/TOOLS.md · 機械可読版：tools.json

安全モデル

AI は呼び出し元であり、権限を持つ主体ではありません。モデルの全体像については、docs/SAFETY.md をご覧ください。

制御	意味
デフォルトはペーパー取引	新しいキーはすべて、5,000 ドルの仮想残高で paper スコープから開始します。実資金の利用は、別途意図的に行う操作です。live スコープは、2 要素目の認証（TOTP、またはパネルで作成したキーの場合はメールコード。OAuth 経由では TOTP が必須）を経た後にのみ発行され、例外なくサーバー側で適用されます。
サーバー側のポリシー壁	取引ごとの最大リスク、注文サイズの上限、日次損失の上限、ポジション数、レバレッジ上限、取引所／銘柄／売買方向の制限を JSON にコンパイルし、リクエストがモデルを離れた後に決定論的に評価します。プロンプトインジェクションによってモデルが「送信する」内容を変えることはできますが、サーバーの評価方法を変えることはできません。
ストップロスは必須	ストップロスがなく、保存済みのデフォルトもない場合、注文は拒否されます。後からストップを削除することもできません。外国為替／MT5 では、テイクプロフィットも必須です。
冪等性	読み取り専用の simulate_order を含む、注文形式のすべてのツールで、クライアントが生成した冪等性キーが必要です。これにより、シミュレーションから発注まで同じキーを使えます。同じキーで再度リクエストすると、二重に実行されるのではなく、保存済みの応答が返されます。
署名付きレシート	すべてのアクションで、ed25519 署名付きのハッシュチェーンレシートが返されます。公開鍵エンドポイント を使って検証できます。
キルスイッチとキーごとの失効	すべてを一度に凍結するか、ほかのクライアントに影響を与えずに 1 つのクライアントを失効させられます。
構造的なテナント分離	ツールには ID パラメーターが一切ありません。アカウントは認証済み接続から導出されるため、混乱したモデルや攻撃者が別のアカウントにアクセスするために渡せる引数はありません。
出金経路なし	取引所 API キーは出金権限なしで作成され、AES-256 で暗号化されて AlgoVesta 内に保持されます。AI が保持するのは、スコープが制限され、失効可能な MCP リンクのみです。

取引所

暗号資産（16） — Binance · Bybit · OKX · KuCoin · Gate.io · Bitget · Kraken · Coinbase · BingX · Hyperliquid · Backpack · HTX · BloFin · Phemex · WOO X · CoinEx

外国為替、貴金属、指数 — MetaTrader 5。インストールは不要です。AlgoVesta が自社の管理サーバー上で MT5 ターミナルを稼働させ、ブローカーに 24 時間 365 日接続します。

シミュレーション — 5,000 ドルの仮想残高を使う組み込みのペーパー取引エンジンです。

6 つの取引所（Binance、Bybit、OKX、Gate.io、KuCoin、Bitget）では、先物と現物の両方で実資金を使ったエンドツーエンドの検証を完了しており、ストップロスとテイクプロフィットが取引所側で設定されることも確認済みです。各取引所には固有の仕様があり、その違いは欠落ではなく意図的なものです。Bybit と Bitget は、現物で 2 つ目のテイクプロフィット注文を受け付けません。OKX の現物取引は、現金口座が気付かないうちに信用取引口座へ変わるのを防ぐため、生 API 経由でルーティングされます。Binance の現物取引では、購入前に最低注文額が適用されます。KuCoin の成行買い注文はコストモードで発注されます。取引所を接続した後にのみ、その取引所を AI が利用できるようになります。未接続の取引所をリクエストすると、推測で応答するのではなく VENUE_NOT_CONNECTED が返されます。

パフォーマンスと上限

上限	値
すべてのツール呼び出し（キーごと）	60 回／分
place_order	10 回／分
replay_channel	5 回／時（結果は 24 時間キャッシュ）

宣伝文句ではなく、実測値です。数値は 2026 年 8 月に測定したもので、平均値は algovesta.com で公開されている値と一致しています。

段階	実測値
リクエストの受け付けと解析	17～67 ms（中央値 38、n=6）
MetaTrader 5 でのエンドツーエンド	平均約 1.2 秒（ストップロスとテイクプロフィットを含む。単一のライブデモ注文：849 ms）
暗号資産取引所でのエンドツーエンド	平均約 4.1 秒（ストップロスとテイクプロフィットを含む。単一のライブ注文：2,785 ms）
ペーパー取引エンジン	中央値 318 ms（n=18、最小 284、最大 769）

AI クライアント内で費やす時間（モデルの思考時間や、ユーザーによる確認時間）は含まれていません。通常、全体の時間の大部分を占めるのはこの時間です。このサーバーは低遅延の執行取引所ではなく、そのようなものとして販売されているわけでもありません。

エンドポイント

目的	URL
MCP — シークレットリンク	https://api.algovesta.com/u/avmcp_<key>/mcp
MCP — OAuth 2.1	https://api.algovesta.com/mcp
ライブイベント（SSE）	https://api.algovesta.com/mcp/events · /u/avmcp_<key>/events
OAuth メタデータ	/.well-known/oauth-authorization-server · /.well-known/oauth-protected-resource
レシート公開鍵	/mcp/receipts/pubkey
ツールスキーマ	https://algovesta.com/mcp/tools.json

公式の MCP Registry に com.algovesta/trading として公開されています。このリポジトリ内の server.json がそのマニフェストです。

FAQ

Claude、ChatGPT、Cursor は、実際に私の取引所アカウントで取引できますか？

はい。live スコープのキーを付与すると取引できます。このスコープは、第 2 要素の認証後にのみ発行されます。それまでは、同じアシスタントが同一のツールを使って 5,000 ドルのペーパーバランスで動作するため、実際のお金を使える状態になる前に、ワークフロー全体を練習できます。

取引所の API キーを AI に渡す必要がありますか？

いいえ。また、どのツールに対しても決して渡さないでください。API キーは出金権限を付与せずに作成され、AlgoVesta 内で暗号化された状態で保持されます。アシスタントが保持するのは MCP リンクだけです。このリンクにはスコープとレート制限が設定され、ポリシーによるチェックが行われ、個別に取り消し可能なため、取引所から資金を移動する用途には使えません。

プロンプトインジェクションによって、AI が私のリスクルールを無視することはありますか？

モデルが要求する内容は変えられる可能性があります。しかし、サーバーの応答方法は変わりません。ルールはリクエストがモデルを離れた後、プロンプトが到達できないコードによって評価され、違反は拒否されて監査ログに記録されます。この保証の範囲については、明確に述べておく必要があります。対象となるのはルールの評価、スコープ、アカウントの分離であり、その後アシスタントがあなたに伝える内容の表現までは対象ではありません。

モデルが誤って place_order を 2 回呼び出すとどうなりますか？

二重に実行されることはありません。すべての書き込みツールでは冪等性キーが必要です。同じキーが再度使われた場合、再実行する代わりに保存済みの応答が返されます。

すべてをすぐに停止するにはどうすればよいですか？

パネルのキルスイッチ（POST /api/mcp/freeze）ですべてを直ちに停止できます。その後、すべてのツールは user_frozen を返します。特定のクライアントだけを遮断するには、そのキーだけを取り消してください。

例

すぐに使えるファイルは examples/ にあります。

• TradingView アラートのテンプレート：6 種類の JSON メッセージ（基本的なエントリー、複数の利確、ポジション状態を含む Pine 戦略、クローズ、MT5 での外国為替、証拠金とレバレッジを使った暗号資産）と、Webhook 受信側で使われるフィールドのリファレンスです。
• Telegram シグナル解析コーパス：合成シグナルメッセージ 30 件と、それぞれの期待される解析結果を収録しています。独自のコピーツールのテストや、AlgoVesta のパーサーが対応する形式の確認に使えます。
• MCP クライアントコード：シークレットリンクで接続し、ポートフォリオを読み取り、ペーパー注文を出す、最小限の Python および Node.js プログラムです。
• クライアント設定：Cursor、VS Code、Gemini CLI。

サポート

アカウントや取引に関するお問い合わせ：サポート · [email protected]
脆弱性の報告：SECURITY.md
接続できないクライアント、または上記の一覧にないクライアントについて：イシューを作成

コンプライアンス

AlgoVestaはシグナルを生成せず、クライアントの資金を保有、受領、移動することも、投資助言を提供することもありません。取引にはリスクが伴い、自動化してもリスクはなくなりません。新しいキーはすべてペーパー取引から開始します。

ライセンス

Copyright (c) 2026 AlgoVesta。このリポジトリ内のドキュメントおよび設定例は、CC BY 4.0 の下でライセンスされています。AlgoVesta MCP サーバー自体はプロプライエタリでホスト型であり、このリポジトリにサーバーのソースコードは含まれていません。