402MCP.org — HTTP 402 & Agent Payment Registry
Decode HTTP 402 payment challenges and compare agent payment rails from an open registry
- Pricing
- Free
- Platforms
- API, CLI, Web
- Runs
- Locally or Remotely
- Version
- 1.1.1
- Listing updated
- 3 days ago
About 402MCP.org — HTTP 402 & Agent Payment Registry
402MCP.org — HTTP 402 & Agent Payment Registry is a free MCP server for finance and payments. It can run locally on your machine or as a hosted remote server.
When an agent hits a 402 Payment Required response, this server works out which scheme the other side speaks (L402, x402 or MPP), what is being asked for and how to pay and retry. A separate recommender filters the registry by role, asset, custody, network, scheme, MCP support and maturity, can re-weight the criteria, and explains every exclusion.
The registry behind it scores payment solutions from 1 to 10 on six equally weighted criteria: custody and sovereignty, operational friction, agent-native support, rails and assets, settlement speed and fees, and developer experience. The homepage lists 14 indexed solutions, led by Lightning Labs Wavelength, with x402, Alby, Coinbase, Stripe and others compared alongside.
Safety is handled explicitly. Fields in a 402 response are treated as untrusted and never repeated as instructions, expired challenges are flagged, and the URL probe refuses private, loopback and metadata addresses. According to the README, no tool can spend money, and every tool is marked read-only.
Install
Run in a terminal
claude mcp add --transport http registry https://402mcp.org/api/v1/mcpAdd to Settings → Connectors → Add custom connector
https://402mcp.org/api/v1/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"registry": {
"url": "https://402mcp.org/api/v1/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"registry": {
"type": "http",
"url": "https://402mcp.org/api/v1/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"registry": {
"serverUrl": "https://402mcp.org/api/v1/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"registry": {
"type": "http",
"url": "https://402mcp.org/api/v1/mcp"
}
}
}Configuration
MCP_402_OFFLINESet to 1 to use the bundled registry snapshot and never fetch.
Tools this server provides (7)
Taken from the project documentation; the running server may differ.
- decode_402_challenge
- Decode a 402 response into next steps and the retry header.
- recommend_payment_rail
- Recommend a payment rail from stated requirements.
- search_402_solutions
- Search the registry with filters.
- get_solution
- One registry entry in full with sources and code samples.
- get_scheme_reference
- Wire format of L402, x402 or MPP.
- probe_402_support
- One GET to a public URL to see whether it speaks 402.
- get_best_payment_solution
- The entry with the highest composite score.
What it does
- 402 challenge decoder
- Turns an L402, x402 or MPP response into exact next steps and the retry header.
- Rail recommender
- Filters and re-weights the registry to suit your requirements.
- Scored registry
- 14 solutions rated on six criteria with sources and verification dates.
- Support probe
- One GET to a public URL to see whether it speaks 402, never paying.
- Scheme reference
- Wire formats for L402, x402 and MPP.
- Untrusted-field handling
- Server-controlled text in challenges is never relayed as instructions.
Good for
- Work out how to pay a 402 response an agent received
- Choose between L402 and x402 for a paid API
- Check whether a URL supports agent payments
- Compare self-custodial rails by settlement speed and fees
Pricing
Free
Free and open registry.
Prices change. Check 402mcp.org before you buy.
402MCP.org — HTTP 402 & Agent Payment Registry FAQ
Can it spend money?
No. The README says no tool can spend money and all are read-only.
Which schemes does it decode?
L402, x402 (v1 and v2) and MPP.
How is the registry scored?
The unweighted mean of six criteria, each rated 1 to 10.
Can I run it offline?
Yes, MCP_402_OFFLINE=1 uses the bundled registry snapshot.
Is 402MCP.org — HTTP 402 & Agent Payment Registry free?
Yes. 402MCP.org — HTTP 402 & Agent Payment Registry is free to use.
How do I add 402MCP.org — HTTP 402 & Agent Payment Registry to Claude Code?
Run this command in your terminal: claude mcp add --transport http registry https://402mcp.org/api/v1/mcp
What are the best alternatives to 402MCP.org — HTTP 402 & Agent Payment Registry?
The closest alternatives to 402MCP.org — HTTP 402 & Agent Payment Registry are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.
Alternatives to 402MCP.org — HTTP 402 & Agent Payment Registry

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools