Hermes Plant — Agent Commerce Assurance

Hermes Plant MCP Server

Hermes Plant 向けの実行可能な MCP サーバーと統合例です。Hermes Plant は、AI エージェントが重要なアクションを事前確認、承認し、その実行を証明できるようにする Agent Commerce Assurance レイヤーです。まずは 1 セントのアクション安全性チェックから始め、リスクの高いアクションだけを署名付きレビュー証拠へと回し、x402 経由で呼び出しごとに支払います。

内容：レジストリークローラーやローカルクライアント向けの実行可能な stdio MCP ブリッジに加え、curl、TypeScript、Python、CrewAI、LangChain のすぐに使える例と、Claude Desktop／Cline／Cursor 用の MCP クライアント設定を収録しています。

リリース前にワークフローを 1 つレビューする

エージェントがあるアクションの承認を受けた後に引数が変更され、タイムアウト後の再試行でそのアクションが二重に実行される可能性があります。何が承認を最終的なアクションに結び付け、重複を防ぎ、実行が完了したかどうかを証明するのでしょうか？

レビュー所見メモのサンプルでは、こうした不備の架空の例、利用可能な証拠、優先順位を付けた修正計画を紹介しています。これはデモであり、クライアントの実績ではありません。

稼働中またはリリース間近のエージェントを持つテクニカル創業者や自動化エージェンシー向けの300 ドルのワークフローレビューでは、1 つのワークフロー、ワークフローマップ、優先順位を付けた所見、実践的な修正計画を提供します。3 時間の上限には、打ち合わせ、準備、メモの作成、1 回の確認ラウンドが含まれます。請求前に、範囲と日程を書面で合意します。実装と本番環境へのアクセスには、別途契約が必要です。

Action Safety スキルをインストールする

Codex、Claude Code、Cursor、その他の Agent Skills 対応クライアント向けに、公開されているフェイルクローズ型の Action Safety スキルをインストールします。

npx [email protected] add JesseGdotIO/hermesplant-mcp-server --skill protect-agent-action

このスキルは、変更されていない正確なアクションを実行する前に 1 セントのクイックゲートを呼び出し、その結果をアクションに結び付けます。追加の 0.25 ドルが承認された場合に限り、リスクが高い、または重大なアクションをエスカレーションします。レビュー時のトリアージを人間による承認として扱うことはなく、このスキルが呼び出し元の権限を拡大することもありません。

ソース： skills/protect-agent-action · インストールガイドと信頼境界

ホスト型 MCP コネクターを使う

本番環境向けの完全なツールセットには、正式なHermes Plant — Agent Commerce Assurance コネクター（Glama）をお使いください。このコネクターは、Action Safety、Spend Assurance、署名付き証拠、支払いポリシーのチェック、コンポーネント x402 ツールを、稼働中の Streamable HTTP エンドポイント経由で提供します。

このリポジトリーは、シークレット不要で利用できるポータブルな検出ブリッジです。ウォレットメッセージへの署名や資金の支出をせずに、レジストリークローラーやローカルクライアントがライブカタログと支払い契約を確認できます。本番ツールを呼び出す購入者向けの方法は、ホスト型コネクターです。

Glama レジストリ

このリポジトリは、秘密情報や資金を入れたウォレットなしで Glama が MCP サーバーをビルドし、検査できるように構成されています。

• glama.json で GitHub のメンテナーを宣言しています。
• ルートの Dockerfile で、mcp-server/ の stdio MCP サーバーを起動します。
• npm run smoke:mcp でローカルの MCP ツールをすべて一覧表示し、稼働中の x402 マニフェストを取得します。
• GitHub Actions で、MCP サーバー、Docker イメージ、シェルの例、実際の依存関係を使用する、支出不要の TypeScript／Python クライアント契約を検証します。

Glama でのリリースは GitHub リリースではなく、アカウント側での操作です。Glama でサーバーの所有権を申請したら、Dockerfile の管理ページからビルドをデプロイし、ビルドテストの合格を待ってから、Glama のリリースバージョンを公開してください。このリリースにより、Glama の Server Coherence と Tool Definition Quality のスコアリングが利用可能になります。

補完的な MCP サーバー

Hermes Plant は重要なアクションと支払いを管理します。以下の独立したサーバーは、エージェントスタックの隣接レイヤーを担います。

• SINT Protocol — 実行前の機能認可とポリシー適用。
• AgentPay MCP — 支出上限と承認キューを備えた、カストディアルでないウォレットの実行。
• Agent Security Scanner MCP — リポジトリ、パッケージ、プロンプト、スキルのセキュリティスキャン。

これらのリンクは機能上の補完性を示すものであり、パートナーシップや推奨を示すものではありません。

保証ワークフローから始める

ワークフロー	用途	トラッキング対象のエントリーポイント
Action Safety	シェル、Git、SQL、デプロイ、x402、MCP のアクションを事前チェックし、リスクの高い作業はレビューと署名付きレシートにエスカレーションします。	ワークフローを開く
Spend Assurance	エージェントが支出する前に、支払いポリシー、ウォレットのコンテキスト、証拠を確認します。	ワークフローを開く
Investment Evidence	決定論的な引受評価を実行し、1 回の有料呼び出しで検証可能な証拠を返します。	ワークフローを開く

無料の API キーでは月あたり最大 250 回呼び出せます。定期的に利用する場合は 月額 $29 の Agent API Pass、または Base 上で呼び出しごとに USDC を利用できます。公開証明と機械可読な契約は、hermesplant.com/proof および hermesplant.com/openapi.json で利用できます。

コンポーネントカタログ

19 個のホスト型 x402 エンドポイントを、組み合わせ可能なユーティリティとして引き続き利用できます。

エンドポイント	用途	ホストされたパス
DealAnalyzer	DCF、IRR、XIRR、NPV	/agent-services/dealanalyzer
Waterfall	LP/GP プライベートエクイティの分配ウォーターフォール	/agent-services/waterfall
Options	Black-Scholes による価格設定とグリークス	/agent-services/options
Bond	利回り、デュレーション、コンベクシティ	/agent-services/bond
CashflowLens	キャッシュフロー予測と感度分析	/agent-services/cashflowlens
PortfolioGuard	ポートフォリオのリスク評価	/agent-services/portfolioguard
WalletGuard	ウォレットの AML および制裁対象スクリーニング	/agent-services/walletguard
EmailGuard	メールのレピュテーションとリスク	/agent-services/emailguard
DestructGuard	AI エージェントによる破壊的なコマンドをブロック	/agent-services/destructguard
MCP risk	接続前に MCP サーバーのリスクを評価	/agent-services/mcp-risk
Evidence	有料の呼び出し用の証拠バンドル	/agent-services/evidence
Payment policy	x402 の支払いポリシーを検査／評価	/agent-services/payment-policy
ReviewQueue	人間参加型の承認ルーティング	/agent-services/reviewqueue

エージェントは、OpenAPI、llms.txt、x402 マニフェスト、API カタログ、MCP メタデータ、またはエージェントスキルを通じてエンドポイントを検出します。上記のワークフローリンクは、この GitHub リポジトリをそれらのソースとして示しています。実際の Glama への掲載では、別のレジストリータグが使われます。ソースタグは観測に基づくものであり、購入者の本人確認や購入の完了を示すものではありません。

x402 の呼び出しの仕組み

Client                    Hermes Plant                 Facilitator
  |                            |                            |
  | POST /endpoint             |                            |
  |--------------------------->|                            |
  | 402 Payment Required       |                            |
  | + PAYMENT-REQUIRED         |                            |
  |<---------------------------|                            |
  | sign payment locally       |                            |
  | POST /endpoint             |                            |
  | + PAYMENT-SIGNATURE        |                            |
  |--------------------------->| verify signature           |
  |                            |--------------------------->|
  |                            | ok                         |
  |                            |<---------------------------|
  | 200 OK + result            | settle payment             |
  |<---------------------------|--------------------------->|

1. クライアントが HTTP リクエストを送信します。
2. サーバーは、価格、ネットワーク、アセット、受取人、タイムアウトを含む PAYMENT-REQUIRED ヘッダーとともに、402 Payment Required を返します。
3. クライアントはチャレンジを解析し、USDC 送金の承認にローカルで署名してから、PAYMENT-SIGNATURE ヘッダーを付けてリクエストを再送します。
4. サーバーはファシリテーターを通じて署名を検証し、処理を実行して、オンチェーンで支払いを決済した後、結果と PAYMENT-RESPONSE ヘッダーを含む 200 OK を返します。

仕様の全文はgithub.com/x402-foundation/x402にあります。

検出手段

これらを利用することで、エージェントや人間は支援なしで自ら利用を開始できます。

• hermesplant.com/llms.txt - エージェントが読み取れるカタログ
• hermesplant.com/openapi.json - OpenAPI 3.1 の全文
• hermesplant.com/.well-known/x402 - ファシリテーター、ネットワーク、アセット、価格、payTo メタデータを含む x402 マニフェスト
• hermesplant.com/.well-known/api-catalog - RFC 9727 スタイルの API カタログ
• hermesplant.com/.well-known/mcp/server-card.json - MCP サーバーの記述子
• hermesplant.com/mcp - ストリーミング可能な HTTP MCP エンドポイント

このリポジトリの MCP ツール

実行可能な stdio サーバーでは、読み取り専用の探索ツールを5つ公開しています。

ツール	目的
hermesplant_x402_manifest	有料呼び出しの前に、最新の x402 マニフェストを取得します。
hermesplant_llms_catalog	エージェントが読み取れる llms.txt カタログを取得します。
hermesplant_api_catalog	機械可読な API カタログを取得します。
hermesplant_mcp_server_card	ホストされた MCP サーバーの記述子を取得します。
hermesplant_list_hosted_tools	ホストされた Streamable HTTP MCP エンドポイントを調査し、公開されているツールを一覧表示します。

これらのローカルツールは、ウォレットメッセージへの署名、トランザクションの承認、有料エンドポイントの呼び出し、USDC の消費を行いません。有料のホスト型ツールを呼び出す前にクライアントが必要とする探索レイヤーを公開します。

クイックスタート

お使いのスタックに合ったランタイムを選んでください。

ランタイム	フォルダー	備考
curl / Bash	curl/	シェルのみで利用可能です。402 ハンドシェイクの確認に便利です。
TypeScript	typescript/	@x402/fetch と @modelcontextprotocol/sdk を使用します。
Python	python/	x402 パッケージを使用します。
CrewAI	crewai/	Hermes エンドポイントを呼び出す金融エージェントのクルーです。
LangChain	langchain/	Hermes をラップする LangChain の Tool です。
MCP 設定	mcp-config/	Claude Desktop / Cline / Cursor 用の貼り付けるだけの設定です。
MCP サーバー	mcp-server/	探索、サーバーカードの確認、ホスト型ツールの一覧表示を行う、実行可能な stdio MCP ブリッジです。

MCP サーバーをローカルで実行する

npm install
npm run smoke:mcp
npm start

MCP サーバーレジストリのビルド

このリポジトリには、MCP レジストリのクローラー向けに、ルートの glama.json とルートの Dockerfile が含まれています。

docker build -t hermesplant-mcp-server .
docker run --rm -i hermesplant-mcp-server

コンテナは mcp-server/ の stdio MCP ブリッジを起動します。このブリッジは、API キーを必要とせずに Hermes Plant の探索ツールとホスト型 MCP メタデータを公開します。

ソースラベルの例

curl、TypeScript、Python、CrewAI、LangChain の CashflowLens の例では、 x-hermes-channel: github-mcp-repo、x-hermes-medium: repository、および x-hermes-campaign: first-workflow を送信します。x-hermes-content はランタイムを識別します。 有料クライアントはこれらのヘッダーを x402 リクエストに渡すため、402 チャレンジ後の再試行時にも SDK が保持します。 curl では未払いのチャレンジのみを確認します。

別の掲載場所で例を公開する場合は、これらのラベルをその掲載場所のソースとキャンペーンに置き換えてください。ラベルは呼び出し側が申告する観測情報であり、購入者の身元、収益、または無関係な顧客を検証するものではありません。オーナーによる QA では、獲得状況のレポートから除外されるよう、x-hermes-probe: 1 も送信する必要があります。

ウォレットの設定

支払い保護付きの有料呼び出しの例では、次のものが必要です。

• Base mainnet（チェーン ID 8453）上の残高があるウォレット。
• 選択したエンドポイントに十分な USDC と、ガス代用の少量の ETH。
• EVM_PRIVATE_KEY と、明示的なオプトイン HERMES_ALLOW_PAYMENT=1。

付属の CashflowLens クライアントは、支払い要件の上限を $0.20 USDC に設定し、Base mainnet のみを登録します。インポートやテストでは、オプトインを設定しないでください。秘密鍵を絶対にコミットしないでください。これらの本番環境向けの例は、テストネットのサポートをうたうものではありません。テストネット統合の作業には、x402 テスト用リソースサーバーを使用してください。

ステータス

これらの例は、hermesplant.com の本番デプロイを対象としています。エンドポイントのシグネチャは変更される場合があるため、本番環境に移行する前に openapi.json と /.well-known/x402 マニフェストを相互参照してください。

コントリビュート

Issue と PR を歓迎します。新しいランタイムやフレームワークの例を追加する場合は、動作する例を1つと、簡潔な README を添えて PR を作成してください。

ライセンス

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