X402 Payment Gated Http

Name: X402 Payment Gated Http
Author: merkleworks

@merkleworks

代码仓库

关于 X402 Payment Gated Http

Use:

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

基本信息

分类

其他

传输方式

stdio

发布者

merkleworks

提交者

rui da silva

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

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.

FAQ from X402 Payment Gated Http

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.