MCP-Pay

HTTP-уровень монетизации x402 на базе Algorand, который позволяет ИИ-агентам оплачивать MCP-инструменты по принципу «плати за вызов» с точностью до долей цента.

Проблема

Автономные ИИ-агенты, использующие Model Context Protocol (MCP), не могут получить доступ к платным инструментам: кредитные карты, API-ключи и подписки — это человеческие процессы. Создатели инструментов не имеют возможности взимать плату за каждый вызов, а устаревшие блокчейны слишком медленны или дороги для межмашинных микроплатежей.

Related MCP server: Loop MCP DualRail

Решение

MCP-Pay превращает любой MCP-инструмент в мгновенно монетизируемую x402-конечную точку на Algorand.

1. Агент обнаруживает инструменты по адресу GET /mcp/v1/tools (бесплатно, включает JSON-схемы и цены).

2. Агент вызывает POST /mcp/v1/tools/:name/execute без оплаты.

3. Сервер отвечает 402 Payment Required с платёжными метаданными (цена в USDC, адрес получателя, сеть).

4. Локальное промежуточное ПО агента автоматически подписывает перевод USDC на Algorand (ASA 31566704) и повторяет запрос.

5. Фасилитатор GoPlausible проверяет и проводит расчёт в сети (финализация <3,3 с), инструмент выполняется, и результаты возвращаются за один цикл запроса.

Никаких аккаунтов. Никаких ключей. Никаких людей.

УТП

Включённые платные инструменты

Архитектура

┌────────────────────────┐
│   AI AGENT (client/)   │  1. GET /mcp/v1/tools      (discovery)
│  auto-paying MCP agent │  2. POST .../execute       → 402 challenge
└───────────┬────────────┘  3. sign USDC txn locally
            │               4. retry + X-PAYMENT header
            ▼
┌────────────────────────┐
│  MCP-PAY SERVER (Hono) │  x402 paymentMiddleware protects each tool route
│  registry + tools/*    │  executes tool only after verified settlement
└───────────┬────────────┘
            ▼
┌────────────────────────┐
│ GOPLAUSIBLE FACILITATOR│  /verify + /settle on Algorand TestNet
│  https://facilitator.  │  USDC (ASA 31566704) transfer
│  goplausible.xyz       │
└────────────────────────┘

Технологический стек

• TypeScript, Hono

• @x402/core, @x402/avm, @x402/hono, @x402/fetch

• @x402-avm/extensions (обнаружение Bazaar)

• Фасилитатор GoPlausible, USDC в тестовой сети Algorand

Запуск локально

1. Предварительные требования

• Node.js 18+, pnpm (npm i -g pnpm)

• Два аккаунта с финансированием в тестовой сети Algorand:

  • Кошелёк сервера (получатель): только адрес

  • Кошелёк агента (плательщик): мнемоническая фраза, хранится локально — никогда не коммитится

Пополните через кран Lora, включите USDC в обоих аккаунтах в Lora, затем получите тестовый USDC из крана Circle (выберите Algorand Testnet).

2. Настройка

pnpm install
cp .env.example .env

Заполните .env:

AVM_ADDRESS=<server wallet address>          # receiver
AVM_MNEMONIC="<agent 25-word mnemonic>"      # payer, LOCAL ONLY
SERVER_URL=http://localhost:4021

3. Запуск сервера + агента

pnpm server        # terminal 1
pnpm agent         # terminal 2: discovery → 402 → auto-pay → result

Проверка в сети

Каждый успешный вызов проводит реальную транзакцию в тестовой сети:

• Панель фасилитатора: https://facilitator.goplausible.xyz/dashboard

• Обозреватель Lora: https://lora.algokit.io/testnet

Пример транзакции расчёта (из демонстрационного запуска):

TODO: paste Lora transaction link after first live run

API

Дорожная карта

• Защита лимитов расходов: бюджеты на агента, контролируемые промежуточным ПО

• Панель создателя: регистрируйте свой собственный MCP-инструмент с ценой за минуты

• Листинг в Bazaar на GoPlausible, чтобы любой сторонний агент мог обнаруживать инструменты MCP-Pay