X402 Payment Gated Http MCP Server

MCP server for the x402 protocol. Lets AI agents (Claude, Cursor, etc.) discover and call payment-gated HTTP APIs automatically.

Local serverstdioApache-2.0

What is the X402 Payment Gated Http MCP Server?

X402 Payment Gated Http is an MCP project maintained in the merkleworks/x402-mcp repository. The maintainer describes its purpose as “MCP server for the x402 protocol. Lets AI agents (Claude, Cursor, etc.) discover and call payment-gated HTTP APIs automatically”. Read the project documentation for the complete scope.

Installation

The documented npm package is @merkleworks/x402-mcp. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
paid_http_requestExecute HTTP request; if 402, run x402 flow and return final response
discover_x402_apiDiscover payable endpoints (/.well-known/x402 or probe)
pay_x402_endpointCall x402 endpoint with full control (delegator, broadcast URL, etc.)
parse_x402_challengeDecode X402-Challenge header
verify_x402_proofVerify X402-Proof against challenge and request

How to install the X402 Payment Gated Http MCP Server

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

From the project documentation. Replace placeholders and example paths before connecting.