a2a-x402-mcp-services

Продакшн-ориентированные монетизированные MCP-инструменты x402 v2 для реальной коммерции между агентами (A2A).

• Настоящий on-chain-расчёт (без моков, без симулированных платежей)

• Полное соответствие текущей спецификации x402 v2 (сети CAIP-2, заголовки PAYMENT-REQUIRED / PAYMENT-SIGNATURE / PAYMENT-RESPONSE, x402Version: 2, точная схема)

• Официальные пакеты @x402/mcp + @x402/core + @x402/evm

• Готовность к Bazaar (инструменты обнаруживаются через фасилитаторов, реализующих расширение Bazaar)

• Создано для актуальных пробелов экосистемы: операционные утилиты, которые агенты действительно перепокупают

Текущие платные инструменты

Все инструменты используют точную платёжную схему и проводят расчёт через реального фасилитатора.

Related MCP server: Agent Commerce Suite

Чек-лист соответствия x402 v2

• x402Version: 2

• Идентификаторы сетей CAIP-2 (eip155:84532 Base Sepolia по умолчанию, eip155:8453 для mainnet)

• Официальные заголовки (PAYMENT-REQUIRED, PAYMENT-SIGNATURE, PAYMENT-RESPONSE)

• Точная схема через @x402/evm/exact

• Верификация и расчёт через фасилитатора (без собственного расчёта в процессе)

• Метаданные расширения Bazaar для обнаружения MCP-инструментов

• Адрес payTo через переменные окружения (без захардкоженных продакшн-кошельков)

Быстрый старт (testnet)

git clone https://github.com/Disseveru/a2a-x402-mcp-services.git
cd a2a-x402-mcp-services
npm install

# Required: receiving wallet (Base Sepolia)
export X402_PAY_TO_EVM=0xYourTestnetAddress

# Optional overrides
# export X402_NETWORK=eip155:84532
# export X402_FACILITATOR_URL=https://x402.org/facilitator
# export PORT=4022

npm run dev

Проверка работоспособности (бесплатно):

curl http://localhost:4022/health

Каталог инструментов (бесплатно):

curl http://localhost:4022/tools

MCP-эндпоинт (платно):

POST http://localhost:4022/mcp

Используйте любой MCP-клиент с поддержкой x402 v2 (клиентские хелперы @x402/mcp, кошельки под управлением CDP и т.д.). При первом вызове платного инструмента вы получите корректный ответ 402; клиент подписывает его и повторяет запрос с PAYMENT-SIGNATURE; фасилитатор проводит расчёт; возвращается результат инструмента.

Переход на mainnet

1. Укажите адрес приёма средств для mainnet:

   export X402_PAY_TO_EVM=0xYourMainnetAddress

2. Переключите сеть:

   export X402_NETWORK=eip155:8453

3. Используйте продакшн-фасилитатора (например — CDP):

   export X402_FACILITATOR_URL=https://api.cdp.coinbase.com/platform/v2/x402

   (Предоставьте учётные данные CDP, если выбранный фасилитатор их требует.)

4. Запустите сервер. Реальные USDC начнут перемещаться.

Никогда не запускайте mainnet с горячим ключом, на котором хранится больше, чем вы готовы потерять.

Архитектура

src/
  config.ts          – env-driven CAIP-2 + facilitator + payTo
  server.ts          – McpServer + official createPaymentWrapper (@x402/mcp)
  tools/
    definitions.ts   – paid tool implementations (real logic)
  index.ts           – Express host + Streamable HTTP MCP transport

Принципы проектирования

1. Без моков — каждый платный маршрут завершается реальным вызовом расчёта у фасилитатора.

2. Только v2 — никаких устаревших заголовков X-PAYMENT или строк сети версии v1.

3. Операционная полезность — инструменты решают задачи агентов, которые реально перепокупаются (риск, нормализация, выбор фасилитатора).

4. Обнаруживаемость — метаданные Bazaar присутствуют, чтобы агенты могли находить инструменты без захардкоженных URL.

5. Безопасность оператора — адрес получения средств и сеть задаются исключительно через переменные окружения.

Лицензия

MIT