ToolYour

オープンソースの ToolYour MCP

AI エージェント向けのリモート MCP ゲートウェイ：計画 → プレイブックを実行／課題を解決 → 合格するまで検証。

MIT ライセンスです。ホスト型 API／SaaS バックエンドは任意で、オフライン評価とローカルのファイルベースのコントロールプレーンは、それらがなくても動作します。

製品ドキュメント： https://www.toolyour.com/developers/mcp
公式レジストリ： com.toolyour/mcp
npm クライアント（別パッケージ）： @toolyour/sdk（MIT）

クイックスタート

cp .env.example .env
npm install
npm run build:registry   # from monorepo docs/ when regenerating
npm run build
npm run dev

エンドポイント：http://localhost:3090/mcp（互換性のあるホスト向けのレガシー SSE）・Streamable HTTP：/mcp または /mcp/http。 API キーを使用する Streamable HTTP エンドポイントはステートレスです。クライアントにセッションアフィニティは不要で、古い Mcp-Session-Id は無視されます。OAuth で保護された /mcp/chatgpt エンドポイントには、独自のセッション動作があります。

ヘルスチェック：GET /health/mcp · 準備状態：GET /health/mcp/ready · メトリクス：GET /health/mcp/metrics（Prometheus テキスト形式）

認証

X-Api-Key: ty_...

ToolYour REST と同じキーです。無料プラン：月 500 クレジット（ツールのコストは 1～10 クレジット）。MCP が公開するのは API 対応カタログツールのみ（hasApi）です。

ホストの契約

ToolYour は Cursor／Claude に取って代わるものではありません。ホストはエディター、git、ターミナルを引き続き管理します。エージェントは次の手順に従ってください。

1. plan_task（無料）
2. run_playbook または solve_task
3. ワークスペースで rank-1 の loop.nextActions のみを適用する
4. loop.gate が pass になるまで（または停止するまで）、前回の結果をベースラインとして verify_task を実行する

スキルループのレスポンスには、追加の execution エンベロープ（runId、intentId、 intentType、idempotencyKey、projectScope）も含まれます。結果を別の MCP ツールに渡すときは、 このエンベロープを保持してください。非同期ジョブでは、get_run のポーリング ID として execution.runId を再利用します。

内部では、plan_task、solve_task、run_playbook、run_workflow、verify_task は、相関付けと execution エンベロープのために、共通の executeIntent ライフサイクル境界を使用します。 クレジットはゲートウェイの各ツール呼び出し時に精算されます（billing.settledBy = gateway_per_tool）。MCP による 二重請求はありません。無料の recall_context は、再構築の前に目的別のメモリーを呼び出します。

保存済みプレイブック（プライベートベータ）

保存済みプレイブックを使うと、繰り返し利用できる ToolYour のワークフローを、名前とバージョンを付けたレシピとして保存し、 MCP 対応エージェントが再実行できます。V1 が参照するのは、既存の ToolYour スキルまたは ワークフローのみです。任意のシェルコマンドを保存したり、別のエージェントを制御したり、ホストの 承認を回避したりすることはできません。アカウントごとに、所有者に限定されたプレイブックと永続的な実行記録が用意されます。

この機能は、プライベート／デフォルトの MCP デプロイでのみ PLAYBOOKS_BETA=true を設定して有効にしてください。ベータ版では create_saved_playbook、list_saved_playbooks、get_saved_playbook、update_saved_playbook、 run_saved_playbook、get_saved_playbook_run が追加されます。レビュー済みの公開 21 ツールの構成を変更しないよう、 /mcp/chatgpt からは意図的に除外されています。

データモデル、安全な実行境界、ロールアウトのガイダンスについては、保存済みプレイブックのベータ設計を参照してください。

オフライン評価（API キー不要）

npm run ci                 # build + lint + unit/contract/integration + evals
npm run eval:golden        # routing + jobReport fields + verify gate
npm run eval:playbooks     # skill → workflow → synthesizer matrix + fixture coverage
npm run golden:tier1       # host work-package shapes

フィクスチャ：tests/eval/synth-fixtures.json · 目標：tests/eval/goals.jsonl

可観測性（オープンプロトコル）

シグナル	方法
JSON ログ	常時（LOG_LEVEL）
プロセス内カウンター	/health/mcp + /health/mcp/metrics
スパン	OTEL_LOG_SPANS=1 および／または OTEL_EXPORTER_OTLP_ENDPOINT を設定（OTLP/HTTP JSON → Collector／Jaeger／Tempo）

独自の APM は不要です。

任意のホスト型機能

• ゲートウェイ + API キー経由のライブツール実行
• Feature Memory／検証プロファイル（SaaS Mongo）
• 複数レプリカの非同期 get_run 用 Redis

ローカルのデフォルト設定では、ファイルベースのコントロールプレーンジョブが使用されます。

ライセンス

MIT — LICENSE を参照してください。