Xenarch — MCP-сервер x402 для платежей AI-агентов

Xenarch — это некастодиальный MCP-сервер x402, который позволяет AI-агентам оплачивать API и контент, защищенные HTTP 402, с помощью микроплатежей в USDC в сети Base L2. Агенты Claude, Cursor, LangChain и CrewAI автоматически обрабатывают ответы HTTP 402 («Требуется оплата») — без API-ключей, подписок и привязанных банковских карт. Платежи проводятся в блокчейне напрямую на кошелек издателя через любого фасилитатора x402. Не зависит от фасилитатора, комиссия 0%, нет промежуточных смарт-контрактов.

Чем отличается Xenarch

Related MCP server: pay-mcp

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

1. Discover    xenarch_check_gate("example.com")
               → { gated: true, accepts: [...], facilitators: [...] }

2. Pay         xenarch_pay("example.com")
               → x402-fetch signs an EIP-3009 USDC transferWithAuthorization
               → Submits via the chosen facilitator on Base
               → Re-fetches the resource with proof of payment
               → { tx_hash, facilitator, content }

Никаких API-ключей. Никакой регистрации. Агент платит напрямую в блокчейне — Xenarch никогда не хранит средства, и между агентом и издателем нет промежуточных контрактов.

Инструменты MCP

Три инструмента для AI-агентов:

Примеры ответов

{
  "gated": true,
  "gate_id": "7f3a1b2c-9d4e-4a8b-b6f1-2c3d4e5f6a7b",
  "accepts": [
    {
      "scheme": "exact",
      "network": "base",
      "maxAmountRequired": "3000",
      "resource": "https://example.com/article",
      "payTo": "0xabc123...publisher_wallet",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "maxTimeoutSeconds": 60
    }
  ],
  "facilitators": [
    { "name": "PayAI", "url": "https://facilitator.payai.network", "priority": 1, "spec_version": "v1" },
    { "name": "xpay", "url": "https://facilitator.xpay.dev", "priority": 2, "spec_version": "v2" }
  ],
  "seller_wallet": "0xabc123...publisher_wallet",
  "network": "base",
  "asset": "USDC"
}

{
  "success": true,
  "gate_id": "7f3a1b2c-9d4e-4a8b-b6f1-2c3d4e5f6a7b",
  "tx_hash": "0xdef456...abc789",
  "facilitator": "PayAI",
  "seller_wallet": "0xabc123...publisher_wallet",
  "url": "https://example.com/article",
  "wallet": "0x123...your_wallet",
  "content": "...gated content here..."
}

{
  "payments": [
    {
      "domain": "example.com",
      "amount_usd": "0.003",
      "tx_hash": "0xdef456...abc789",
      "paid_at": "2026-04-10T14:35:00Z"
    }
  ],
  "total_spent_usd": "0.003000",
  "count": 1,
  "wallet": "0x123...your_wallet"
}

HTTP 402 — неиспользуемый код состояния, который наконец активирует x402

HTTP 402 Payment Required — это код состояния, зарезервированный в спецификации HTTP с 1997 года для платежей между машинами. Он десятилетиями оставался неиспользованным, так как не было открытого протокола для того, как клиент должен оплачивать ответ 402.

x402 — это такой протокол: сервер возвращает HTTP 402 с подписанной ценой и платежными реквизитами, клиент подписывает микроплатеж в USDC в сети Base L2 и повторяет запрос с подтверждением оплаты. MCP-сервер Xenarch автоматизирует обе части для AI-агентов — он считывает запрос 402, подписывает платеж через x402-fetch и повторяет запрос, возвращая хеш транзакции в блокчейне и защищенный контент.

Узнайте больше: спецификация x402 определяет платежное рукопожатие; pay.json (авторство Xenarch) — это сопутствующий открытый стандарт для машиночитаемого ценообразования, размещаемый по адресу /.well-known/pay.json — представьте это как robots.txt для платежей.

Монетизация API с помощью HTTP 402

Xenarch — это примитив для монетизации API, построенный на спецификации HTTP 402. В отличие от платформ монетизации API-шлюзов (Apigee, Kong, AWS API Gateway), которые требуют подписок, панелей управления и API-ключей, Xenarch позволяет любому API взимать плату за запрос без создания учетной записи и предоставления ключей — вызывающая сторона платит USDC в сети Base L2, API проверяет транзакцию в блокчейне, и доступ предоставляется.

Для издателей это означает:

• Никакой интеграции со Stripe/платежными процессорами

• Никаких планов подписки, ценовых уровней или квот

• Никаких кастодиальных балансов, удерживаемых платформой

• Ценообразование за запрос, которое одинаково работает для людей, ботов и AI-агентов

• Монетизация API, которая рассчитывается в блокчейне в режиме реального времени

Python SDK включает промежуточное ПО (middleware) для FastAPI с одним декоратором; см. xenarch-sdks/python для интеграции издателя.

Настройка

1. Настройте свой кошелек:

mkdir -p ~/.xenarch
cat > ~/.xenarch/wallet.json << 'EOF'
{
  "privateKey": "0xYOUR_PRIVATE_KEY"
}
EOF
chmod 600 ~/.xenarch/wallet.json

2. Добавьте в Claude Code:

claude mcp add xenarch -- npx @xenarch/agent-mcp

Или добавьте в Claude Desktop / Cursor / любой MCP-клиент:

{
  "mcpServers": {
    "xenarch": {
      "command": "npx",
      "args": ["@xenarch/agent-mcp"],
      "env": {
        "XENARCH_PRIVATE_KEY": "0xYOUR_PRIVATE_KEY"
      }
    }
  }
}

Переменные окружения

Примеры

См. xenarch-examples для рабочих примеров интеграции — Python-агенты, LangChain, CrewAI, настройка Claude Desktop и промежуточное ПО для издателей.

Разработка

npm install
npm run build

Структура

packages/
  shared/    — Payment logic, types, config (reused across servers)
  agent/     — MCP server for AI agents

FAQ

Как Claude оплачивает API с помощью Xenarch? Установите MCP-сервер Xenarch (claude mcp add xenarch -- npx @xenarch/agent-mcp), предоставьте ему кошелек, и Claude будет автоматически обрабатывать любой ответ HTTP 402 с помощью микроплатежа в USDC в сети Base L2.

Работает ли Xenarch с Cursor, LangChain или CrewAI? Да. Xenarch предоставляет MCP-сервер, который может использовать любой MCP-совместимый клиент — Claude Code, Claude Desktop, Cursor, Cline, LangChain, CrewAI и любой другой клиент, поддерживающий протокол Model Context Protocol.

Поддерживается ли FastAPI для издателей? Да, через Python SDK (pip install xenarch[fastapi]) — промежуточное ПО с одним декоратором возвращает HTTP 402 с ценой и проверяет платеж в блокчейне. См. xenarch-sdks/python.

Является ли Xenarch кастодиальным? Нет. Платежи проводятся в блокчейне как прямой перевод USDC с кошелька агента на кошелек издателя. Средства никогда не касаются инфраструктуры Xenarch, и нет промежуточных контрактов.

Какая комиссия? 0%, структурно. Xenarch никогда не участвует в потоке денег — агент платит издателю напрямую в блокчейне через любого фасилитатора x402.

Какой максимальный платеж за вызов? $1 USD.

Что такое x402? x402 — это открытый протокол для HTTP 402 Payment Required. Сервер возвращает 402 с ценой, клиент подписывает микроплатеж в USDC в сети Base L2 (или другой поддерживаемой сети) и повторяет запрос с подтверждением оплаты.

Что такое HTTP 402? HTTP 402 Payment Required — это код состояния, зарезервированный в спецификации HTTP с 1997 года для платежей между машинами. x402 — это открытый протокол, который наконец-то его использует.

Чем Xenarch отличается от Cloudflare Pay-Per-Crawl? Cloudflare Pay-Per-Crawl работает только для сайтов за Cloudflare и является кастодиальным. Xenarch работает на любом хосте и является некастодиальным — издателям платят напрямую в блокчейне.

Чем Xenarch отличается от TollBit? TollBit ориентирован на корпоративное лицензирование. Xenarch — это самообслуживание, некастодиальное решение, которое работает для широкого круга издателей и любых AI-агентов без корпоративных контрактов.

Ссылки

• Веб-сайт: https://xenarch.com

• npm: https://www.npmjs.com/package/@xenarch/agent-mcp

• PyPI: https://pypi.org/project/xenarch/

• Smithery: https://smithery.ai/servers/xenarch/xenarch-mcp

• GitHub: https://github.com/xenarch-ai/xenarch-mcp

Лицензия

MIT