# 402MCP.org — HTTP 402 & Agent Payment Registry

> 402MCP.org — HTTP 402 & Agent Payment Registry is a free MCP server for finance and payments. Decode HTTP 402 payment challenges and compare agent payment rails from an open registry. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API, CLI, Web
- **Website:** https://402mcp.org
- **Repository:** https://github.com/402mcp/402mcp
- **MCP Registry name:** org.402mcp/registry
- **Categories:** finance and payments, developer tools
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http registry https://402mcp.org/api/v1/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://402mcp.org/api/v1/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "registry": {
      "url": "https://402mcp.org/api/v1/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "registry": {
      "type": "http",
      "url": "https://402mcp.org/api/v1/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "registry": {
      "serverUrl": "https://402mcp.org/api/v1/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "registry": {
      "type": "http",
      "url": "https://402mcp.org/api/v1/mcp"
    }
  }
}
```

## Tools

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

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/402mcp-org-http-402-and-agent-payment-registry
