ツールリファレンス

Axiory.ai MCPサーバーは、すべての取引操作、マーケットデータクエリ、システム管理を処理する19個のMCPツール(一部のクライアントでは「関数」とも呼ばれます)を公開しています。各ツールはFIX 4.4プロトコル経由で特定の取引または情報操作にマッピングされます。

MCPツールとは

MCPツールはAIエージェントがアクション実行のために呼び出せる関数です。APIメソッドのようなものと考えてください — やりたいことを英語で記述すると、AIエージェントが適切なツールを正しいパラメータで呼び出し、構造化された結果が返ってきます。一部のツールは状態を変更します(注文を発注する)が、他のツールは情報を読み取るだけです(価格を確認する)。

ツールカテゴリ

19個のツールは5つのカテゴリに整理されています:

取引 (4ツール)

注文の発注、変更、キャンセル。これらはブローカーに実際の注文を送信する(ライブモード)、または検証する(ペーパーモード)破壊的操作です。

ツール	説明	モード	アノテーション
place_order	新規注文を送信(MARKET、LIMIT、STOP)	paper/live	破壊的、非冪等
modify_order	待機注文の数量、価格、ストップ価格を変更	paper/live	破壊的、非冪等
cancel_order	約定前の待機注文をキャンセル	paper/live	破壊的、冪等
close_position	成行注文でオープンポジションをクローズ	paper/live	破壊的、非冪等
close_all_positions	すべてのポジションをクローズ(またはシンボル指定)	paper/live	破壊的、非冪等

マーケットデータ (3ツール)

ライブ価格をクエリし、リアルタイムクォートを購読します。これらはリスクチェックなしの読み取り専用操作です。

ツール	説明	モード	アノテーション
get_quote	1つのシンボルの現在価格を取得	all	読み取り専用、冪等
get_quotes	複数シンボルの価格を取得(バッチ)	all	読み取り専用、冪等
subscribe_quotes	ライブのビッド/アスク価格を購読	paper/live	非冪等

ポートフォリオ (3ツール)

オープンポジション、待機注文、クローズ済み取引履歴を表示します。これらは読み取り専用操作です。

ツール	説明	モード	アノテーション
get_positions	評価損益付きですべてのオープンポジションを表示	all	読み取り専用、冪等
get_orders	待機中/オープン中の注文を表示	all	読み取り専用、冪等
get_trade_history	確定損益と統計付きでクローズ済み取引を表示	all	読み取り専用、冪等

情報 (3ツール)

シンボルの検索、組み込みドキュメントへのアクセス、システムヘルスのチェック。これらは読み取り専用操作です。

ツール	説明	モード	アノテーション
get_symbols	シンボルカタログをクエリ(ID、ロットサイズ、アセットクラス)	all	読み取り専用、冪等
get_knowledge	組み込みドキュメントとガイドにアクセス	all	読み取り専用、冪等
check_health	サーバーヘルス、FIX状態、リスク制限を確認	all	読み取り専用、冪等

セッション管理 (4ツール)

FIXセッションと認証を管理します。これらは接続性とセッション制御のためのインフラツールです。

ツール	説明	モード	アノテーション
reconnect_trade_session	TRADE FIXセッションを強制再接続	paper/live	破壊的、冪等
reconnect_quote_session	QUOTE FIXセッションを強制再接続	paper/live	冪等
reset_session	すべてのトークンを取り消し、認証をリセット	paper/live	破壊的、非冪等
submit_feedback	バグレポートまたは機能リクエストを送信	all	非冪等、オープンワールド
get_feedback_status	送信したフィードバックのステータスを確認	all	読み取り専用、冪等

モード別利用可否

モード	取引可能?	データ読み取り可能?	セッション管理可能?
readonly	いいえ(拒否)	はい	いいえ
paper	はい(シミュレート)	はい	はい
live	はい(実取引)	はい	はい

各モードの詳細はOperating Modesを参照してください。

ツールアノテーション(動作のヒント)

各ツールには動作を示すアノテーションがあります:

• read-only — 状態を変更しません。複数回呼び出しても問題ありません。
• destructive — 状態を変更します(注文の作成/キャンセル、ポジションのクローズ)。注意して使用してください。
• idempotent — 同じパラメータで複数回呼び出しても副作用なし。ネットワーク障害時のリトライが安全です。
• non-idempotent — 同じパラメータでの複数回呼び出しは異なる結果(重複注文の作成)を生みます。盲目的なリトライは危険です。
• open-world — 外部システム(フィードバック用のGitHub APIなど)と相互作用する可能性があり、非決定的な動作をする場合があります。

リスクチェック

取引ツールは実行前に自動リスクチェックを実行します:

1. キルスイッチ — 日次損失制限を超えるとすべての取引がブロックされます
2. レート制限 — スパム(同一シンボルへの急速な注文)を防止
3. 動作モード — paperまたはliveである必要があります(readonlyは不可)
4. シンボルホワイトリスト — シンボルが存在し有効である必要があります
5. アセットクラス別ポジションサイズ — 単一ポジションが設定された最大値を超えてはいけません
6. 最大オープンポジション数 — 総ポジション数が制限されます(リンクされたSL/TPはカウントされません)
7. 日次損失制限 — 確定損失が設定された日次上限を超えてはいけません
8. 数量検証 — 数量は正かつ妥当である必要があります

各チェックの詳細はRisk Managementを参照してください。

クイックリファレンス

やりたいこと別…

• 注文を発注する → place_order
• 待機注文を変更する → modify_order
• 注文をキャンセルする → cancel_order
• ポジションをクローズする → close_position
• すべてのポジションをクローズする → close_all_positions
• ポジションを確認する → get_positions
• 待機注文を確認する → get_orders
• 現在価格を取得する → get_quote または get_quotes
• ライブ価格を購読する → subscribe_quotes
• クローズ済み取引を表示する → get_trade_history
• シンボルを検索する → get_symbols
• ドキュメントを読む → get_knowledge
• 接続状況を確認する → check_health
• 切断時に再接続する → reconnect_trade_session または reconnect_quote_session
• バグを報告する → submit_feedback
• フィードバックの状況を確認する → get_feedback_status
• モード変更または再認証する → reset_session

個別ツールページ

各ツールには以下を含む専用リファレンスページがあります:

• 完全なパラメータ説明
• 使用例
• レスポンス形式
• エラーコードと対処法
• ワークフローのヒント

よく使用するツールに移動してください:

• place_order
• modify_order
• cancel_order
• close_position
• close_all_positions
• get_quote
• get_quotes
• subscribe_quotes
• get_positions
• get_orders
• get_trade_history
• get_symbols
• get_knowledge
• check_health
• reconnect_trade_session
• reconnect_quote_session
• reset_session
• submit_feedback
• get_feedback_status

重要な概念

単位 vs ロット

すべての数量パラメータは**単位(units)**で指定されます(ロットではありません):

• FXペア(EURUSD): 100,000単位 = 1標準ロット、10,000単位 = 0.1ロット
• ゴールド(XAUUSD): 10単位 = 1標準ロット、100単位 = 10ロット
• シルバー(XAGUSD): 500単位 = 1標準ロット

取引前にget_symbolsを呼び出して、各銘柄のロットサイズを確認してください。

positionIdによるポジションリンク

SL/TP注文を既存のポジションにリンクするには、positionIdが必要です。positionIdがないと、STOPまたはLIMIT注文は対象ポジションをクローズせず、新しい独立したポジションをオープンします:

正しい例:
1. place_order (MARKET, side=BUY, volume=100000, symbol=EURUSD)
   → positionId="pos-123"を返す
2. place_order (STOP, side=SELL, volume=100000, symbol=EURUSD, positionId="pos-123", stopPrice=1.0950)
   → 価格が1.0950に達したらポジションをクローズ

誤った例:
1. place_order (MARKET, side=BUY, volume=100000, symbol=EURUSD)
   → positionId="pos-123"を返す
2. place_order (STOP, side=SELL, volume=100000, symbol=EURUSD, stopPrice=1.0950)
   → pos-123をクローズせず、新しいポジションをオープン(positionIdなし)

OCO (One-Cancels-Other)

SLとTPの注文を同じポジションにリンクすると、片方が約定したときにサーバーがもう一方を自動キャンセルします:

ポジション: 1ロット EURUSD LONG
SL: 1.0900のSTOP
TP: 1.1000のLIMIT

価格が1.1000に達した場合:
- TPが約定(利益確定でクローズ)
- SLは自動キャンセルされる

ベストプラクティス

1. 常にプライスキャッシュを温めておく — 正確な評価損益を得るため、get_positionsの前にget_quotesを呼び出す
2. まずペーパーモードを使う — ライブ取引前に注文ロジックをテスト
3. 取引前にヘルスを確認する — check_healthで接続性を確認
4. 盲目的にリトライしない — 非冪等ツール(place_order)はエラー時にリトライすべきではありません
5. SL/TPにはpositionIdを使う — これがないと独立したポジションが作成されます
6. 日次損失を監視する — check_healthで日次損失制限への接近度を確認
7. エラー応答を注意深く読む — 問題解決のための提案が含まれています
8. ジャーナルを使う — すべての操作は監査とデバッグのためにログ記録されます

リソースとプロンプト

これらのツールに加えて、サーバーは以下を提供します:

• MCPリソース — エージェントがアクセスできる構造化されたナレッジベーストピック
• MCPプロンプト — エージェントの動作を導く事前定義されたシステムプロンプト

詳細はResourcesおよびPromptsを参照してください。