Advertise
MCP.so
Sign In
X

X402 Payment Gated Http MCP Server

@merkleworks

Repository

Basic information

Category

Other

Transports

stdio

Author

merkleworks

Submitted by

rui da silva

About X402 Payment Gated Http MCP Server

Use:

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

X402 Payment Gated Http MCP Server config

Add this server to your MCP-compatible client using the configuration below.

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

X402 Payment Gated Http MCP Server tools

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

Overview

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.

Frequently asked questions

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

Comments

More Other MCP servers

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

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

Senso MCP for Joomla

sensomedia

Senso MCP turns a Joomla 5 or 6 site into a remote MCP server. It runs inside Joomla itself (no extra server, no Node.js bridge) and is secured with OAuth 2.1 and Joomla's own ACL. The free pack lets an AI assistant crea

YOUB

Connect your AI assistant to your own YOUB endurance training account. Read recorded activities with full analysis, planned sessions, race goals, wellness (HRV, sleep, resting HR) and your athletic profile. Create or mov

N

Next Generation Movers: free moving quotes (remote MCP)

Next Generation Movers

Free moving quotes for AI agents from Next Generation Movers, a licensed interstate mover (USDOT 3764697). US long-distance nationwide and local DC/MD/VA. Indicative ballpark price and booking options; optional $0.01 x40

Advertise