x402 Universal Payer — MCP-сервер для Claude Code: оплата
MCP-сервер, который сам платит по протоколу x402 за платные API: агент получает ответ и квитанцию расчёта, а расход ограничен лимитами.
claude mcp add --env MCP_BRIDGE_EVM_PRIVATE_KEY=<MCP_BRIDGE_EVM_PRIVATE_KEY> --env MCP_BRIDGE_SVM_PRIVATE_KEY=<MCP_BRIDGE_SVM_PRIVATE_KEY> --env MCP_BRIDGE_MAX_PRICE_PER_CALL_ATOMIC=<MCP_BRIDGE_MAX_PRICE_PER_CALL_ATOMIC> --env MCP_BRIDGE_MAX_TOTAL_ATOMIC=<MCP_BRIDGE_MAX_TOTAL_ATOMIC> --env MCP_BRIDGE_ALLOWED_PAYTO=<MCP_BRIDGE_ALLOWED_PAYTO> --transport stdio mcp-bridge -- npx -y @three-ws/mcp-bridgeЧто делает x402 Universal Payer
Сервер подключается к агенту и берёт на себя оплату. Вы даёте агенту URL, тот отвечает 402 Payment Required, дальше мост подписывает платёж, повторяет запрос и возвращает ответ вместе с разбором расчёта. Поддержаны EVM exact, EVM batch-settlement и Solana exact.
Внутри четыре инструмента. call_paid_endpoint — универсальный: бьёт по любому URL и платит, если пришёл 402. list_bazaar_tools и refresh_bazaar бесплатные: первый отдаёт кэш найденных сервисов, второй перезапрашивает Bazaar и перерегистрирует инструменты без перезапуска. Плюс по инструменту на каждый ресурс из Bazaar, до MCP_BRIDGE_DISCOVER_LIMIT. Инструменты с ценой выше лимита на вызов отсеиваются ещё при обнаружении.
Сервер держит приватные ключи и тратит настоящие USDC. Нужен отдельный кошелёк с малым балансом: MCP_BRIDGE_EVM_PRIVATE_KEY или MCP_BRIDGE_SVM_PRIVATE_KEY, хотя бы один. Лимит на вызов задаёт MCP_BRIDGE_MAX_PRICE_PER_CALL_ATOMIC, потолок за сессию — MCP_BRIDGE_MAX_TOTAL_ATOMIC; после его достижения платежи прекращаются до перезапуска. Есть список разрешённых получателей и хостов, а исходящие URL проходят проверку на приватные и loopback-адреса. Повторный платный вызов — это новый платёж.
Какие задачи решает
- оплатить платный API прямо из агента, без ручного выставления счёта
- получить ответ и квитанцию расчёта по x402-эндпоинту
- ограничить траты агента лимитом на вызов и потолком за сессию
- подключить сервисы из x402 Bazaar как готовые инструменты
- запретить платежи на незнакомые адреса и хосты
Примеры запросов агенту
- Оплати $0.01 в сети Base за прогноз погоды и покажи квитанцию
- Обнови список инструментов из Bazaar через
refresh_bazaar - Вызови
call_paid_endpointдля этого URL и верни ответ
Как установить x402 Universal Payer
Командой платформы
claude mcp add --env MCP_BRIDGE_EVM_PRIVATE_KEY=<MCP_BRIDGE_EVM_PRIVATE_KEY> --env MCP_BRIDGE_SVM_PRIVATE_KEY=<MCP_BRIDGE_SVM_PRIVATE_KEY> --env MCP_BRIDGE_MAX_PRICE_PER_CALL_ATOMIC=<MCP_BRIDGE_MAX_PRICE_PER_CALL_ATOMIC> --env MCP_BRIDGE_MAX_TOTAL_ATOMIC=<MCP_BRIDGE_MAX_TOTAL_ATOMIC> --env MCP_BRIDGE_ALLOWED_PAYTO=<MCP_BRIDGE_ALLOWED_PAYTO> --transport stdio mcp-bridge -- npx -y @three-ws/mcp-bridgeВместо <…> подставьте свои значения. Ещё 8 переменных окружения — в README сервера
Командой платформы
codex mcp add mcp-bridge --env MCP_BRIDGE_EVM_PRIVATE_KEY=<MCP_BRIDGE_EVM_PRIVATE_KEY> --env MCP_BRIDGE_SVM_PRIVATE_KEY=<MCP_BRIDGE_SVM_PRIVATE_KEY> --env MCP_BRIDGE_MAX_PRICE_PER_CALL_ATOMIC=<MCP_BRIDGE_MAX_PRICE_PER_CALL_ATOMIC> --env MCP_BRIDGE_MAX_TOTAL_ATOMIC=<MCP_BRIDGE_MAX_TOTAL_ATOMIC> --env MCP_BRIDGE_ALLOWED_PAYTO=<MCP_BRIDGE_ALLOWED_PAYTO> -- npx -y @three-ws/mcp-bridgeВместо <…> подставьте свои значения. Ещё 8 переменных окружения — в README сервера
Файл настроек
{
"mcpServers": {
"mcp-bridge": {
"command": "npx",
"args": [
"-y",
"@three-ws/mcp-bridge"
],
"env": {
"MCP_BRIDGE_EVM_PRIVATE_KEY": "<MCP_BRIDGE_EVM_PRIVATE_KEY>",
"MCP_BRIDGE_SVM_PRIVATE_KEY": "<MCP_BRIDGE_SVM_PRIVATE_KEY>",
"MCP_BRIDGE_MAX_PRICE_PER_CALL_ATOMIC": "<MCP_BRIDGE_MAX_PRICE_PER_CALL_ATOMIC>",
"MCP_BRIDGE_MAX_TOTAL_ATOMIC": "<MCP_BRIDGE_MAX_TOTAL_ATOMIC>",
"MCP_BRIDGE_ALLOWED_PAYTO": "<MCP_BRIDGE_ALLOWED_PAYTO>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 8 переменных окружения — в README сервера
Файл настроек
{
"servers": {
"mcp-bridge": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@three-ws/mcp-bridge"
],
"env": {
"MCP_BRIDGE_EVM_PRIVATE_KEY": "<MCP_BRIDGE_EVM_PRIVATE_KEY>",
"MCP_BRIDGE_SVM_PRIVATE_KEY": "<MCP_BRIDGE_SVM_PRIVATE_KEY>",
"MCP_BRIDGE_MAX_PRICE_PER_CALL_ATOMIC": "<MCP_BRIDGE_MAX_PRICE_PER_CALL_ATOMIC>",
"MCP_BRIDGE_MAX_TOTAL_ATOMIC": "<MCP_BRIDGE_MAX_TOTAL_ATOMIC>",
"MCP_BRIDGE_ALLOWED_PAYTO": "<MCP_BRIDGE_ALLOWED_PAYTO>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 8 переменных окружения — в README сервера
Командой платформы
gemini mcp add -e MCP_BRIDGE_EVM_PRIVATE_KEY=<MCP_BRIDGE_EVM_PRIVATE_KEY> -e MCP_BRIDGE_SVM_PRIVATE_KEY=<MCP_BRIDGE_SVM_PRIVATE_KEY> -e MCP_BRIDGE_MAX_PRICE_PER_CALL_ATOMIC=<MCP_BRIDGE_MAX_PRICE_PER_CALL_ATOMIC> -e MCP_BRIDGE_MAX_TOTAL_ATOMIC=<MCP_BRIDGE_MAX_TOTAL_ATOMIC> -e MCP_BRIDGE_ALLOWED_PAYTO=<MCP_BRIDGE_ALLOWED_PAYTO> mcp-bridge npx -y @three-ws/mcp-bridgeВместо <…> подставьте свои значения. Ещё 8 переменных окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о x402 Universal Payer
Как установить x402 Universal Payer в Claude Code?
Выполните `claude mcp add x402-bridge -e MCP_BRIDGE_EVM_PRIVATE_KEY=<MCP_BRIDGE_EVM_PRIVATE_KEY> -e MCP_BRIDGE_SVM_PRIVATE_KEY=<MCP_BRIDGE_SVM_PRIVATE_KEY> -- npx -y @three-ws/mcp-bridge`, затем перезапустите клиент.
Что делает x402 Universal Payer?
Платит за платные x402-эндпоинты от имени агента: подписывает платёж, повторяет запрос и возвращает ответ с разбором расчёта. Ещё подгружает инструменты из x402 Bazaar.
Какие ключи нужны для работы?
Хотя бы один: MCP_BRIDGE_EVM_PRIVATE_KEY для Base и других EVM-сетей или MCP_BRIDGE_SVM_PRIVATE_KEY для Solana. Кошелёк лучше отдельный и с небольшим балансом.
