TollWarden — MCP-сервер для Claude Code: проверка x402-платежей
Сканирует исходящий x402-платёж до расчёта и возвращает allow, flag или block. Пригодится агентам, которые платят за данные и API.
claude mcp add tollwarden -- npx -y tollwardenЧто делает TollWarden
TollWarden встаёт между решением агента заплатить и подписью кошелька. Агент отправляет платёж на POST /v1/scan/outgoing, сервер отвечает вердиктом с причинами по каждой проверке: allow — кошелёк рассчитывается, flag — агент останавливается и уточняет намерение, block — подпись не проходит. Сервер ничего не хранит у себя: ключи, кошельки и средства остаются у вас, TollWarden только советует.
Ловит он несколько типовых схем. Утечку секретов в метаданных платежа: приватные ключи EVM, сид-фразы, ключи облачных и AI-сервисов, JWT, учётные данные в URL. Повтор уже использованной авторизации по nonce. Двойную оплату одной покупки — x402-клиент подписывает новую авторизацию на каждый ответ 402, поэтому повторный запрос выглядит как второй валидный платёж. Завышение цены относительно ожидаемой. И платежи, решение о которых пришло из только что прочитанной страницы или результата инструмента, а не из плана агента.
Для работы нужен API-ключ: клиент @tollwarden/client выпускает его сам и даёт 100 бесплатных сканов. Есть SDK для TypeScript и Python, интеграции с LangChain, CrewAI, NeMo Agent Toolkit, Coinbase AgentKit и Vercel AI SDK. Владельцам кошельков доступен TollWardenEnforcer — он оборачивает подписанта viem или ethers и физически отказывается подписывать авторизацию без свежего allow-вердикта, привязанного к этому платежу.
Какие задачи решает
- поймать утечку приватного ключа или API-ключа в метаданных платежа до отправки
- отклонить повторно предъявленную авторизацию по nonce
- заметить вторую подпись за ту же покупку при повторном запросе
- остановить платёж, спровоцированный прочитанной страницей
- заблокировать оплату по цене выше ожидаемой
Примеры запросов агенту
- Проверь этот x402-платёж через TollWarden перед подписью
- Отметь текст страницы, которую только что прочитал агент, и проверь, не подталкивает ли она к оплате
- Подключи TollWarden к кошельку, чтобы он не подписывал платёж без allow-вердикта
Как установить TollWarden
Командой платформы
claude mcp add tollwarden -- npx -y tollwardenКомандой платформы
codex mcp add tollwarden -- npx -y tollwardenФайл настроек
{
"mcpServers": {
"tollwarden": {
"command": "npx",
"args": [
"-y",
"tollwarden"
]
}
}
}Файл настроек
{
"servers": {
"tollwarden": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"tollwarden"
]
}
}
}Командой платформы
gemini mcp add tollwarden npx -y tollwardenПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о TollWarden
Как установить TollWarden в Claude Code?
Одной командой: claude mcp add tollwarden -- npx -y tollwarden.
Что делает TollWarden?
Проверяет исходящий x402-платёж до расчёта и возвращает allow, flag или block с причинами по каждой проверке. Секреты, повтор nonce, двойная покупка, завышенная цена и платёж по подсказке из прочитанного контента — всё это он отмечает.
Нужен ли TollWarden доступ к моему кошельку?
Нет. Он не касается ключей и средств, а только выносит вердикт. Для жёсткого запрета есть TollWardenEnforcer, который оборачивает подписанта viem или ethers.
