MCP x402 — AIエージェントのための証拠に基づくWeb検証

エージェントが行動する前に、販売者、製品、オファー、ポリシー、または主張を検証

AIエージェントに公開HTTP(S)ページと1〜10個の具体的な条件を与えます。verificar_condicoes ツールは、すべての条件について証拠に基づく判定を返します:

• confirmado — ページが条件を明確に支持している。

• rejeitado — ページが条件を明確に矛盾している。

• incerto — ページの証拠が不十分である。

各検証には、最終的なソースURL、ページタイトル、タイムスタンプ、条件ごとの説明、利用可能な場合の引用証拠、一意の verificationId、およびSHA-256の pageHash が含まれます。

対象

• AIによる購入・調達エージェント;

• 販売者、製品、オファーの検証;

• 購入前のデューデリジェンス;

• ポリシーおよび利用規約のチェック;

• 行動する前に証拠を必要とする商業自動化。

シンプルなx402統合

• 支払い前の無料プレフライト検証。

• Baseメインネットでの検証1回につき $0.05 USDC。

• アカウントやサブスクリプションは不要。

• MCPおよびHTTPで利用可能。

• このリポジトリにすぐ実行できるバイヤーが含まれています。

• Coinbase x402バリデーションに合格し、Bazaarディスカバリが有効。

ライブエンドポイント

• MCP: https://mcp-x402-production.up.railway.app/mcp

• 無料の検証プレフライト: POST https://mcp-x402-production.up.railway.app/preflight/verify-conditions

• 有料検証: POST https://mcp-x402-production.up.railway.app/verify-conditions

• ヘルス: GET https://mcp-x402-production.up.railway.app/health

このサービスは、analisar_url と consultar_ia を通じて、有料の公開URL分析と一般的なAI相談も提供します。

Related MCP server: Pylon MCP Server

ライブサービス

• ベースURL: https://mcp-x402-production.up.railway.app

• ヘルスチェック: GET /health

• MCPエンドポイント: POST /mcp

• 有料URL分析: POST /analyze

• 料金: 有料リクエスト1回につき $0.05 USDC

• ネットワーク: Baseメインネット (eip155:8453)

本番稼働状況

• Railwayで本番デプロイが稼働中

• x402バージョン2の支払いフロー

• Baseメインネット支払い (eip155:8453)

• Coinbase x402バリデーションに合格

• HTTP 402によるシミュレーションが受け入れ済み

• Bazaarディスカバリメタデータ有効

• Coinbaseインデックス有効

MCPツール

判定検証

verificar_condicoes — $0.05 USDC

エージェント向けの有料判定検証ツール。

公開URLと1つ以上の具体的な条件を渡します。そのページから抽出された証拠のみに基づいて判定を返します:

• confirmado — ページが条件を明確に証明している。

• rejeitado — ページが条件を明確に矛盾している。

• incerto — ページが十分な証拠を提供していない。

各結果には、最終的なソースURL、ページタイトル、検証タイムスタンプ、条件ごとの説明、および利用可能な場合は短い引用証拠が含まれます。

条件の例:

• 「ページが販売者を特定している。」

• 「製品がポルトガルで利用可能である。」

• 「ページがユーロでの価格を示している。」

• 「文書がサービスがx402をサポートしていると述べている。」

これは、次の行動を取る前に証拠に基づく判定を必要とするエージェント向けに設計されています。

技術

• Node.jsおよびTypeScript

• Express

• Model Context Protocol

• OpenAI Responses API

• x402支払い

• viem

• Cheerio

• Railway

セキュリティ

• RailwayによるHTTPS

• Helmetセキュリティヘッダー

• 15分間に100リクエストのレート制限

• 一意のリクエストID付きの構造化リクエストログ

• ホスト検証およびRailwayヘルスチェックサポート

• /v1/responses のみにアクセス可能な制限付きOpenAI APIキー

• 環境ファイルとシークレットはGitから除外

環境変数

サーバー

ローカルバイヤー

ローカル .env.test ファイルの例:

EVM_PRIVATE_KEY=your_private_key_here

ローカル開発

依存関係をインストール:

npm install

開発サーバーを起動:

npm run dev

プロジェクトをビルド:

npm run build

コンパイル済みサーバーを起動:

npm start

ヘルスチェック

ヘルスエンドポイントは公開されており、支払いは不要です:

curl https://mcp-x402-production.up.railway.app/health

すぐに実行できるx402バイヤー

リポジトリには、アプリケーションおよびAIエージェント向けのすぐに実行できるバイヤーが含まれています。MCPバイヤーはライブサービスに接続し、BaseメインネットUSDCおよび最大支払額 $0.05 に対するx402支払い要件を検証し、支払いに署名し、同じツール呼び出しを再試行し、決済レシートと結果を出力します。

バイヤーをクローンして準備:

git clone https://github.com/Diogoup26/mcp-x402.git
cd mcp-x402
npm install

プロジェクトルートにローカルの .env.test ファイルを作成:

EVM_PRIVATE_KEY=0xYOUR_64_HEX_CHARACTER_PRIVATE_KEY

.env.test をコミットしたり、秘密鍵を公開したりしないでください。

プロジェクトをビルド:

npm run build

次のコマンドは、Baseメインネット上で実際のx402支払いを承認します:

• consultar_ia: $0.02 USDC

• analisar_url: $0.05 USDC

• verificar_condicoes: $0.05 USDC

HTTP URL分析

npm run analyze -- "https://example.com" "Summarize this page."

HTTP判定検証

npm run verify -- "https://example.com" "The page identifies the seller."

MCP URL分析

npm run mcp:analyze -- "https://example.com" "Summarize this page."

MCP AI相談

npm run mcp:consult -- "Reply only with: MCP OK"

MCP判定検証

npm run mcp:verify -- "https://example.com" "The page identifies the seller."

MCP支払いが成功すると、以下が出力されます:

• PAGAMENTO MCP: success

• 決済レシート

• ツールの応答

MCPバイヤーは秘密鍵を決して出力せず、次のいずれかの支払いを拒否します:

• Baseメインネット上にない;

• 設定されたBase USDCコントラクトを使用していない;

• $0.05 USDCを超えている。

デプロイ

main ブランチはRailwayに接続されています。プッシュが成功するたびに新しいデプロイがトリガーされます。Railwayは次を使用します:

npm run build
npm start

デプロイのヘルスチェックパスは /health です。

ライセンス

ISC