ProvenPaid

provenpaid-mcp

有料の x402 エンドポイントを利用する前に、エージェントが事前にチェックできるようにします。支払いの前に証拠を確認。

ProvenPaid は、エージェントが x402 エンドポイントを利用する前にチェックします。支払いチャレンジは有効か、実際のウォレットはオンチェーンで支払いを行い、その後戻ってきているか、また支払いはどの程度集中しているかを確認します。この MCP サーバーは、そのチェックをツールとして提供します。最初の 10 回のチェックは無料で、ウォレットもセットアップも不要です。 その後は、管理下にあるウォレットからチェックごとに約 $0.01 相当の Base 上の USDC を自動で支払います。

不慣れなエンドポイントを利用する前に 1 回だけ使用し、呼び出すたびにチェックする必要はありません。

ツール

ツール	費用	機能
check_x402_endpoint(url)	最初の 10 回は無料、その後は約 $0.01	エンドポイントの x402 チャレンジを検証し、受取アドレスに関する公開オンチェーン情報（異なる支払者数、リピーターの割合、支払者の集中度、カバレッジ）を報告します。
provenpaid_methodology()	無料	各シグナルの算出方法、検証されない項目、チェックが課金されるタイミングを説明します。
provenpaid_status()	無料	残りの無料チェック回数、支払い用ウォレットのアドレス、ネットワーク、価格上限、当日の残り有料チェック回数を表示します。

URL が無効または安全でない場合、x402 エンドポイントではない場合、あるいは Base 上の USDC で支払えるオプションがない場合、課金されません。結果は証拠であり、結論ではありません。ProvenPaid はサービスの品質や、エンドポイントが受取アドレスを管理しているかどうかを検証しません。

インストール

Python 3.11 以降が必要です。uv を使用する場合：

uvx provenpaid-mcp

または pip install provenpaid-mcp を実行します。

無料で試す（ウォレット不要）

{
  "mcpServers": {
    "provenpaid": { "command": "uvx", "args": ["provenpaid-mcp"] }
  }
}

初回の実行時に、ローカルの ID キー（~/.provenpaid-mcp/identity.key、所有者のみアクセス可能）が作成されます。このキーに資金は含まれません。ProvenPaid が無料チェックの 10 回分をカウントするためだけに使用されます。証拠が返されたチェックのみがカウントされます。

無料チェック終了後も利用を続ける

専用の、残高を少額に抑えたウォレットを追加します。

{
  "mcpServers": {
    "provenpaid": {
      "command": "uvx",
      "args": ["provenpaid-mcp"],
      "env": {
        "PROVENPAID_WALLET_PRIVATE_KEY": "0x...",
        "PROVENPAID_DAILY_LIMIT": "20"
      }
    }
  }
}

ウォレットの安全性

• Base 上の USDC を数ドル分だけ保有する専用ウォレットを使用してください。重要な資金が入ったウォレットは絶対に使用しないでください。
• キーはお使いのマシン上にのみ保持され、メモリ内でのみ使用されます。ログに記録されたり、ツールから返されたり、外部に送信されたりすることはありません。プロセス外に出るのは署名済みの支払い承認のみです。
• ETH は不要です。ネットワーク手数料は支払いファシリテーターが負担します。

次のガードレールは、何かに署名する前に適用されます。

設定	デフォルト	意味
PROVENPAID_MAX_PRICE_USD	0.01	これを超える価格のチェックを拒否します（上限は 0.10）。
PROVENPAID_DAILY_LIMIT	20	UTC の 1 日あたりの有料チェックの最大回数です。再起動後も保持されます。
PROVENPAID_NETWORK	eip155:8453	このネットワーク上でのみ、そのネットワークの USDC で支払います。Base Sepolia でテストする場合は eip155:84532 を指定します。
PROVENPAID_API_URL	https://api.provenpaid.com	https である必要があります。
PROVENPAID_STATE_DIR	~/.provenpaid-mcp	1 日あたりのカウンターの保存場所です。

仕組み

サーバーは GET https://api.provenpaid.com/v1/check?url=... を呼び出します。API は x402 の支払い要件とともに HTTP 402 を返します。公式の x402 SDK が上記のガードレール内で 1 回限りの USDC 承認に署名し、再試行します。決済はチェックによって証拠が返された場合にのみ行われます。手法については https://api.provenpaid.com/methodology をご覧ください。

ライセンス

MIT