402-mcp

Nostr: npub1mgvlrnf5hm9yf0n5mf9nqmvarhvxkc6remu5ec3vf8r0txqkuk7su0e7q2

👁 MIT licence
👁 TypeScript
👁 Node
👁 Coverage
👁 Nostr
👁 GitHub Sponsors

L402 + x402 клиент MCP, который наделяет AI-агентов экономической субъектностью. Находите, оплачивайте и используйте любые API с платной подпиской — без регистрации, API-ключей и посредников.

• Поиск платных API в Nostr — URL-адреса не нужны заранее

• Автооплата через Lightning (NWC), Cashu ecash или QR-код для ручного подтверждения

• Учетные данные кэшируются и шифруются в хранилище (AES-256-GCM)

• Работает с любым L402-сервером — toll-booth, Aperture или любой будущей реализацией

Быстрый старт

1. Установка

npx 402-mcp

2. Подключение к Claude Code

claude mcp add 402-mcp -- npx 402-mcp

3. Попробуйте

Спросите Claude: "Search for paid joke APIs using l402-search" — кошелек не нужен, только поиск.

Готовы совершать платные вызовы? Ознакомьтесь с полным руководством по быстрому старту, чтобы настроить кошелек и увидеть, как ваш агент оплачивает свой первый вызов API.

Related MCP server: ag402-mcp

Как это работает

graph LR
 A["1. l402-config()"] --> B["2. l402-discover(url)"]
 B --> C["3. Agent reasons<br/>about pricing"]
 C --> D["4. l402-buy-credits()<br/>or l402-fetch()"]
 D --> E["5. l402-fetch(url)<br/>with credentials"]
 E --> F["6. Data returned<br/>+ balance cached"]

Пример сессии:

Agent: "I need routing data from routing.trotters.cc"

1. l402-config()
 -> nwcConfigured: true, maxAutoPaySats: 1000

2. l402-discover("https://routing.trotters.cc/api/route")
 -> 10 sats/request, toll-booth detected, tiers available

3. Agent reasons: "I need ~20 requests. The 500-sat tier
 gives 555 credits. Better value."

4. l402-buy-credits(url, amountSats=500)
 -> Paid 500 sats, received 555 credits

5. l402-fetch("https://routing.trotters.cc/api/route?from=...&to=...")
 -> 200 OK, route data, 545 credits remaining

Подробную архитектуру и диаграммы потоков платежей см. в docs/architecture.md.

Конфигурация

Выбор транспорта и резервные варианты

Когда событие типа 31402 анонсирует несколько URL (по одному на транспорт), 402-mcp выбирает лучший на основе вашей конфигурации:

1. Приоритет — если TRANSPORT_PREFERENCE=tor и доступен .onion URL, он будет опробован первым.

2. Резервный вариант — если предпочтительный транспорт недоступен (прокси не настроен, тайм-аут), клиент переходит к следующему URL в списке.

3. Стандартный интернет (clearnet) — если предпочтения не заданы, URL в обычном интернете пробуются перед .onion или HNS.

Сервисы могут анонсировать несколько конечных точек для одного и того же сервиса (одна цена, один ключ макаруна) на разных транспортах. Это сделано исключительно для устойчивости к цензуре; вам не нужно проходить повторную аутентификацию при смене транспорта. Для доступа к Tor или HNS-адресам необходимо настроить соответствующие переменные окружения для прокси/шлюза.

Инструменты

Базовый L402 (любой сервер)

Расширения toll-booth

Способы оплаты

Три платежных канала, проверяемых в порядке приоритета:

1. NWC (Nostr Wallet Connect) — полностью автономно; оплата с подключенного кошелька

2. Cashu — полностью автономно; обмен токенов ecash для оплаты счетов

3. Ручное подтверждение — отображение QR-кода, ожидание оплаты

Агент может переопределить метод для каждого вызова, или вы можете настроить только те методы, которые вам нужны.

l402-fetch прозрачно обрабатывает четыре варианта HTTP 402:

Безопасность

MAX_AUTO_PAY_SATS ограничивает любой отдельный автономный платеж. Выше этого лимита агент должен запросить одобрение у человека. Агент может прочитать этот лимит через l402-config и учитывать его при принятии решений о покупке.

Конфиденциальность

402-mcp хранит учетные данные только локально на вашем компьютере (~/.402-mcp/credentials.json, зашифровано в покое). Никакие данные не отправляются третьим лицам. Никаких аккаунтов, отслеживания или аналитики. Платежи используют Lightning или Cashu — они псевдонимны по своей природе.

Экосистема

Изучайте активные L402-сервисы на 402.pub — децентрализованной торговой площадке для API с платной подпиской.

402-mcp — это независимая от платежных каналов альтернатива lightning-agent-tools от Lightning Labs и x402 от Coinbase — не требуется Lightning-нода, поддерживаются разные кошельки и зашифрованные учетные данные.

Используйте инструменты Lightning Labs, если хотите, чтобы агенты запускали свою собственную Lightning-ноду. Используйте 402-mcp, если хотите, чтобы агенты платили с любого кошелька без инфраструктуры.

См. CONTRIBUTING.md для настройки разработки и руководств.

Создано @forgesworn.

• Lightning чаевые: thedonkey@strike.me

• Nostr: npub1mgvlrnf5hm9yf0n5mf9nqmvarhvxkc6remu5ec3vf8r0txqkuk7su0e7q2

Часть набора инструментов ForgeSworn

ForgeSworn создает инструменты с открытым исходным кодом для криптографической идентификации, платежей и координации в Nostr.

Лицензия

MIT

Maintenance

Resources

• NPM Package
• GitHub Repository
Need Help?Related Servers