agentdocs

agentdocs

agentdocs は、公開ドキュメントに基づいて IMBA エージェントプラットフォームに関する質問に回答します。対象には、エージェントの標準情報、ユースケースのプレイブック、ティアポリシー、各 MCP をカタログのどこに掲載するか、公開ドキュメント URL の一覧、許可リストに登録された個々の公開ドキュメント URL の内容が含まれます。

これは転送クライアントであり、ウォレットではありません。ドキュメントで説明されている製品は、プリペイドカード／暗号資産対応のエージェントウォレットですが、このパッケージが提供するのはドキュメントの取得のみです。元のドキュメントサーバーと同じ 6 つの読み取り専用ツールだけを提供し、運用、登録、入金、購入、出金の機能は一切ありません。取得した各ツールの説明には、このインターフェースでは資金を動かさないことが繰り返し記載されています。get_public_url もほかのツールと同じように転送され、許可リストは上流で適用されます。

ツール

• get_agent_facts — プリペイドエージェントの標準ポリシーとカタログです。Visa プリペイド、eSIM、ギフトカード、KYT アドレススクリーニング、USDT TRC-20、禁止されている決済手段、ティアが含まれます。引数はありません。
• get_agent_use_cases — エージェントが購入できるものと、用途ごとの MCP ツールをまとめたプレイブックです。引数はありません。
• get_tier_policy — Tier 0 と Tier 1 以上の変換・出金ポリシーです。引数はありません。
• get_catalog_placement — ドキュメント用 MCP と支出用 MCP のそれぞれを掲載するディレクトリを示します。引数はありません。
• get_public_url — 許可リストに登録された公開ドキュメント URL を 1 つ取得します。必須の引数は url です（許可リスト内の https://imbawallet.com の絶対 URL）。
• list_docs_urls — 公開エージェント URL の一覧を取得します。HowTo、ユースケース、ティア、ディスカバリー、OpenAPI、MCP エンドポイントが含まれます。引数はありません。

tools/list は、公開されているリモートからそのまま取得したツール定義をローカルで提供します。tools/call は上流に転送され、結果（content、structuredContent、および isError フラグがある場合はそのフラグ）がそのまま返されるため、上流の拒否（たとえば get_public_url の許可リストエラー）も変更されずに伝わります。

設定

• IMBA_DOCS_MCP_URL（任意。再構築用と明記）— ドキュメントのエンドポイントを上書きします。デフォルトは https://imbawallet.com/mcp/docs です。

エラーは、この再構築版独自のエラーテキスト（再構築用と明記）として表示されます。agentdocs error: ... の形式で、JSON-RPC エラーには上流のメッセージが、HTTP エラーにはステータスが含まれ、解析できない応答は不正な応答として報告されます。

転送の仕組み

最初の転送呼び出しでは、クライアントが initialize リクエスト（protocolVersion 2025-03-26、clientInfo name agentdocs、version 0.1.0）を POST し、返された場合は Mcp-Session-Id レスポンスヘッダーを取得します。次に notifications/initialized を POST し、その後、取得したセッションヘッダーがあれば付加して tools/call リクエストを POST します。セッションはプロセスの終了まで再利用されます。すべての POST には Content-Type: application/json と Accept: application/json, text/event-stream が設定され、応答は通常の JSON または SSE（data: 行）の場合があります。

CLI

各ツールは、JSON 引数文字列を 1 つ受け取るサブコマンドです。

npx @reneturcios/agentdocs get_agent_facts '{}'
npx @reneturcios/agentdocs get_public_url '{"url":"https://imbawallet.com/agent/howto"}'
npx @reneturcios/agentdocs list_docs_urls '{}'
npx @reneturcios/agentdocs --version

出力は、転送された結果の content を JSON として表したものです。終了コード：成功時は 0、isError の結果が返された場合は 1、使用方法に誤りがある場合は 2 です。

MCP サーバー

npx -y @reneturcios/agentdocs mcp

MCP クライアントの設定：

{
  "mcpServers": {
    "agentdocs": {
      "command": "npx",
      "args": ["-y", "@reneturcios/agentdocs", "mcp"]
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/agentdocs
docker run --rm ghcr.io/cloudcorprecords/agentdocs list_docs_urls '{}'

開発

npm install
npm run build   # tsc -> dist/
npm test        # tsx --test test/*.test.ts (fake fetch only, no network)
npm run dev     # run the CLI from source

ライセンス

MIT — Copyright (c) 2026 Rene Turcios