X402 Payment Gated Http

Created By

merkleworks4 months ago

Use: Allows AI agents to call payment-gated HTTP APIs using the x402 protocol. Send a request; if the server returns 402 Payment Required, the MCP server handles the challenge, payment, and retry with proof, then returns the API response. Primary tool: paid_http_request.

# Infrastructure

# Payments

Overview Content Tools Comments

Overview

What it does
x402 Payment-Gated HTTP lets AI agents call HTTP APIs that use the x402 protocol. If the API responds with 402 Payment Required, the MCP server handles the challenge, builds the payment, and retries with a proof, then returns the final response.

Primary tool

paid_http_request — Send a request to a URL; if the server returns 402, the flow (parse challenge → pay → retry with proof) runs automatically and the tool returns the API response.

Other tools

discover_x402_api — Find payable endpoints (e.g. from /.well-known/x402 or by probing).
pay_x402_endpoint — Call a known x402 endpoint with full control.
parse_x402_challenge / verify_x402_proof — Inspect and verify x402 headers.

Install

npx @merkleworks/x402-mcp

Example (Cursor)
Add to .cursor/mcp.json:

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

Example tool call

Tool: paid_http_request
Input: { "url": "https://your-x402-api.example.com/v1/expensive", "method": "GET" }

Try in Playground

Server Config

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

Project Info

Created At

4 months ago

Updated At

4 months ago

Author Name

merkleworks

Star

Language

License

Recommend Servers

View All

ContextBridge

@tijuthomas5

ContextBridge (CB) is a local-first retrieval layer that sits between your codebase and your AI coding agent. Instead of pasting raw source files into context or letting the AI guess which files matter, CB indexes your codebase's real structure (via Graphify) and returns a compact, ranked result — owner file, related files, key symbols, and dependency chains — grounded in your actual code. A typical response is ~4–8 KB instead of the 100+ KB of raw source an AI would otherwise need to read to answer the same question — roughly a 96% cut in input tokens sent to your cloud AI, with zero hallucinated file paths or method names.

13 days ago

EdgeOne Pages MCP

@TencentEdgeOne

An MCP service designed for deploying HTML content to EdgeOne Pages and obtaining an accessible public URL.

TypeScript

a year ago

MCP Advisor

@istarwyh

MCP Advisor & Installation - Use the right MCP server for your needs

TypeScript

a year ago

Malta Payments Mcp

@junter1989k-ai

12 days ago

Perplexity Ask MCP Server

@ppl-ai

A Model Context Protocol Server connector for Perplexity API, to enable web search without leaving the MCP ecosystem.

JavaScript

a year ago

Kazakhstan Payments Mcp

@junter1989k-ai

12 days ago

Tavily Mcp

@tavily-ai

JavaScript

a year ago

12 days ago

GBOX provides environments for AI Agents to operate computer and mobile devices. Mobile Scenario: Your agents can use GBOX to develop/test android apps, or run apps on the Android to complete various tasks(mobile automation). Desktop Scenario: Your agents can use GBOX to operate desktop apps such as browser, terminal, VSCode, etc(desktop automation). MCP: You can also plug GBOX MCP to any Agent you like, such as Cursor, Claude Code. These agents will instantly get the ability to operate computer and mobile devices.

a year ago

12 days ago

百度地图核心API现已全面兼容MCP协议，是国内首家兼容MCP协议的地图服务商。

a year ago

Algeria Payments Mcp

@junter1989k-ai

12 days ago

Guatemala Payments Mcp

@junter1989k-ai

12 days ago

EverArt

@modelcontextprotocol

AI image generation using various models

a year ago

Arcgis Portal Mcp

@Asem-D

MCP server for ArcGIS Portal and ArcGIS Online. Lets AI assistants search content, query feature layers, manage features, handle content operations, and administer users and groups. Built on the Model Context Protocol for integration with Claude Desktop, Cursor, VS Code Copilot, and other MCP clients. Disclaimer: This is an independent open-source project. It is not affiliated with, endorsed by, or sponsored by Esri Inc. "ArcGIS" is a registered trademark of Esri.

12 days ago

MCP Server for Milvus

@zilliztech

The Milvus MCP server enables AI applications to interact with Milvus vector databases using natural language commands. It allows AI models to perform vector searches, manage collections, and retrieve data without writing custom database queries. This integration facilitates seamless access to vector data, enhancing the capabilities of AI tools like Claude Desktop and Cursor.

a year ago

Qatar Payments Mcp

@junter1989k-ai

12 days ago

Sentry

@modelcontextprotocol

Retrieving and analyzing issues from Sentry.io

a year ago

Costa Rica Payments Mcp

@junter1989k-ai

12 days ago

Filesystem