X402 Payment Gated Http MCP Server

@merkleworks

リポジトリ

基本情報

カテゴリ

その他

トランスポート

stdio

作者

merkleworks

投稿者

rui da silva

X402 Payment Gated Http MCP Server について

Use:

#infrastructure #payments #apis #x402#bsv#402

X402 Payment Gated Http MCP Server の設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

{
  "mcpServers": {
    "x402": {
      "command": "npx",
      "args": [
        "@merkleworks/x402-mcp"
      ]
    }
  }
}

X402 Payment Gated Http MCP Server のツール

Discover x402 payable API endpoints on a host. Fetches /.well-known/x402 manifest or probes the URL for a 402 challenge. Returns a list of payable endpoints with their prices in satoshis.

Call an x402-gated API endpoint with automatic payment. Sends the request, handles the 402 challenge, constructs a BSV payment transaction, delegates for fee completion, broadcasts to the network, and retries with proof. Returns the API response after successful payment.

Parse an X402-Challenge header value into structured JSON. Decodes the base64url payload and returns the challenge fields: nonce UTXO, price, payee, expiry, request binding, and whether the challenge has expired.

Verify an X402-Proof header against a challenge and request details. Performs structural validation, binding checks, hash verification, and expiry checks. Does not verify mempool acceptance or client signatures (those require network access).

概要

What is X402 Payment Gated Http?

X402 Payment Gated Http is an MCP server that lets AI agents call HTTP APIs using the x402 protocol. When an API responds with a 402 Payment Required status, the server automatically handles the payment challenge, builds the proof, retries the request, and returns the final response.

How to use X402 Payment Gated Http?

Install via npx @merkleworks/x402-mcp. Configure in your MCP client (e.g., Cursor’s .cursor/mcp.json) by pointing the command to that package. Then invoke tools such as paid_http_request with a URL and method to make payment-gated HTTP calls.

Key features of X402 Payment Gated Http

paid_http_request – sends an HTTP request and automatically handles 402 challenges.
discover_x402_api – finds payable endpoints (e.g., from /.well-known/x402 or probing).
pay_x402_endpoint – calls a known x402 endpoint with full control.
parse_x402_challenge / verify_x402_proof – inspect and verify x402 headers.
Runs entirely via npx; no separate installation steps required.

Use cases of X402 Payment Gated Http

AI agents accessing premium APIs that require micropayments per request.
Automating calls to a paywalled data source without manual payment handling.
Discovering and interacting with unknown x402-enabled endpoints programmatically.
Testing and debugging x402 protocol headers from within an MCP environment.

よくある質問

What is the x402 protocol?

x402 is a protocol that allows HTTP APIs to request payment (402 status) and include a challenge; the client then constructs and attaches a cryptographic proof of payment to retry the request.

How does the automatic payment flow work?

When an API responds with 402, the server parses the challenge, builds the required payment, retries the request with the proof, and returns the API’s final response.

What tools does the MCP server provide?

It offers `paid_http_request` (main), `discover_x402_api`, `pay_x402_endpoint`, `parse_x402_challenge`, and `verify_x402_proof`.

What are the runtime dependencies?

The server runs via `npx` and only requires Node.js. No additional libraries or wallets are mentioned in the README.

How is the server invoked in an MCP client?

Add it to the MCP configuration (e.g., `mcpServers.x402` in `.cursor/mcp.json`) with `command: "npx"` and `args: ["@merkleworks/x402-mcp"]`.

「その他」の他のコンテンツ

EverArt

modelcontextprotocol

Model Context Protocol Servers

88.1K

Health by Dr Brad

Dr Brad Stanfield

Health by Dr Brad works out a health plan from your own results: which screening is due at your age, and evidence-based suggestions, each with the reason and the published guideline or study behind it. Your record is one

MaxKB

1Panel-dev

🔥 MaxKB is an open-source platform for building enterprise-grade agents. 强大易用的开源企业级智能体平台。

22.0K

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K

Screenpipe

screenpipe

YC (S26) | Open Computer History | Continuously record your company computer work, map your workflows, help you find work worth automating, and power your agents' context