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

402MCP.org — HTTP 402 & Agent Payment Registry — MCP-сервер для Claude Code: разбирает ответы HTTP 402 и подсказывает агенту, как заплатить и повторить запрос.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Автор: 402MCP
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/402MCP/402mcp
- Обновлён: 2026-10-18
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/mcp/402mcporg-http-402-agent-payment-registry

## Что делает

Сервер даёт инструмент `decode_402_challenge`, который разбирает ответ 402 — макарун L402 с инвойсом BOLT 11, x402 версий v1 и v2 или MPP — и возвращает точные следующие шаги и заголовок для повторного запроса. Отдельный инструмент `recommend_payment_rail` подбирает платёжный рельс по роли, активу, типу хранения, инфраструктуре, сети, схеме и зрелости решения, с возможностью менять вес критериев. Инструмент `probe_402_support` делает один GET-запрос к публичному URL, чтобы проверить поддержку 402, и не выполняет платежи.

Все поля ответа 402 помечены как недоверенные: сервер не исполняет текст из них как инструкции, а отдельно отмечает просроченные challenge и макаруны с хешем платежа, не совпадающим с инвойсом. Проверка URL отказывается от приватных, loopback и link-local адресов и нестандартных портов, а на хостинге запросы к ней ограничены по частоте.

За рекомендациями стоит реестр решений, где каждая запись получает оценку от 1 до 10 по шести критериям и источники для проверки. Для локальной установки через stdio нужен пакет `@402mcp/mcp`, подключаемый через `npx`.

## Требования
- Нужно: Node.js (команды через npx)
- Удалённый сервер: `https://402mcp.org/api/v1/mcp`
- Переменные окружения: `MCP_402_OFFLINE` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

1. **Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http registry https://402mcp.org/api/v1/mcp
```

2. **Командой платформы**
```bash
claude mcp add --env MCP_402_OFFLINE=<MCP_402_OFFLINE> --transport stdio 402mcporg-http-402-agent-payment-registry -- npx -y @402mcp/mcp
```
Вместо <…> подставьте свои значения

### Codex

1. **Командой платформы: удалённый сервер**
```bash
codex mcp add 402mcporg-http-402-agent-payment-registry --url https://402mcp.org/api/v1/mcp
```

2. **Командой платформы**
```bash
codex mcp add 402mcporg-http-402-agent-payment-registry --env MCP_402_OFFLINE=<MCP_402_OFFLINE> -- npx -y @402mcp/mcp
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "402mcporg-http-402-agent-payment-registry": {
            "url": "https://402mcp.org/api/v1/mcp"
        }
    }
}
```
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "402mcporg-http-402-agent-payment-registry": {
            "command": "npx",
            "args": [
                "-y",
                "@402mcp/mcp"
            ],
            "env": {
                "MCP_402_OFFLINE": "<MCP_402_OFFLINE>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "402mcporg-http-402-agent-payment-registry": {
            "type": "http",
            "url": "https://402mcp.org/api/v1/mcp"
        }
    }
}
```
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "402mcporg-http-402-agent-payment-registry": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@402mcp/mcp"
            ],
            "env": {
                "MCP_402_OFFLINE": "<MCP_402_OFFLINE>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

1. **Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http 402mcporg-http-402-agent-payment-registry https://402mcp.org/api/v1/mcp
```

2. **Командой платформы**
```bash
gemini mcp add -e MCP_402_OFFLINE=<MCP_402_OFFLINE> 402mcporg-http-402-agent-payment-registry npx -y @402mcp/mcp
```
Вместо <…> подставьте свои значения

## Когда брать
- разобрать ответ `402 Payment Required` от сервера с L402, x402 или MPP
- подобрать платёжный рельс под роль, актив и требования к хранению
- проверить, поддерживает ли конкретный URL оплату по HTTP 402, без реального платежа
- получить эталонное описание формата L402, x402 или MPP
- найти и сравнить решения в открытом реестре агентных платежей

## Примеры запросов агенту
- Разбери этот ответ 402 и скажи, что нужно для оплаты и повтора запроса
- Подбери платёжный рельс с некастодиальным хранением и поддержкой x402
- Проверь, отвечает ли этот URL схемой 402, без оплаты

## Похожие
- [okx-agent-payments-protocol](https://affpapa.org/nevibecode/skills/okx-agent-payments-protocol.md) — скилл · 16200 установок
- [Lightning Enable MCP Server](https://affpapa.org/nevibecode/mcp/lightning-enable-mcp-server.md) — MCP-сервер · ★ 9 у репозитория
- [402-mcp](https://affpapa.org/nevibecode/mcp/402-mcp.md) — MCP-сервер
- [🚀 P-Link - Collect/Send/Receive payments](https://affpapa.org/nevibecode/mcp/p-link-collectsendreceive-payments.md) — MCP-сервер · 828 установок

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
