广告合作
MCP.so
登录
X

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 工具

4

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.

常见问题

1

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.

2

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.

3

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`.

4

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.

5

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"]`.

评论

其他 分类下的更多 MCP 服务器

Maestro

mobile-dev-inc

Painless E2E Automation for Mobile and Web

14.8K

MCP Toolbox for Databases

googleapis

MCP Toolbox for Databases is an open source MCP server for databases.

15.9K

Lemon.io

lemon-io

Request dedicated senior developers to work on your project, write job descriptions, and prep technical interviews — all without leaving your Claude chat. Just describe what you need, and Lemon.io MCP does the rest. 1–3

Codelf

unbug

A search tool helps dev to solve the naming things problem.

14.2K

Handl

Handl speaks the Model Context Protocol. Your whole billing operation — projects, invoices, clients, reports, approvals — as tools any AI assistant can call, inside your autonomy rules.

广告合作