Skip to content
MCP server

402MCP.org — HTTP 402 & Agent Payment Registry

Decode HTTP 402 payment challenges and compare agent payment rails from an open registry

Install
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/mcp

Add to Settings → Connectors → Add custom connector

https://402mcp.org/api/v1/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "registry": {
      "url": "https://402mcp.org/api/v1/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools