PayPerByte MCP Server

Сервер Model Context Protocol, который даёт AI-агентам прямой доступ к PayPerByte — криптографически аттестованным, проверяемым по происхождению потокам данных для AI-агентов (квитанция X-BYTE-Attestation доказывает целостность доставки — это ровно те байты, которые PayPerByte обслужил и аттестовал в домене BYTE Library, — а не то, что их подписал независимый издатель данных, и не то, что данные корректны). Агенты находят потоки, платят за вызов через x402 (расчёт в USDC в основной сети Base), либо подписываются на ончейн-потоки (тестовая сеть Arbitrum Sepolia). Каждый платный ответ x402 несёт квитанцию EIP-712 PayloadAttestation (заголовок X-BYTE-Attestation), которую агент проверяет перед действием. Никаких токенов, никаких API-ключей, никаких офчейн-аккаунтов.

Два рельса — прочтите это перед установкой PRIVATE_KEY.

• x402 оплата за вызов (byte_buy_data): основная сеть Base (eip155:8453), НАСТОЯЩИЙ USDC. Платные потоки расчётны реальными деньгами — флагманский Merchant Screen Oracle стоит $0.10 за вердикт: подписанная проверка ALLOW/WARN/BLOCK домена мерчанта и платёжного адреса, подкреплённая подписанной EIP-712-аттестацией по точным байтам ответа, выполняемая до того, как агент проведёт x402-платёж на этот адрес. Аутентичность и целостность доставки, а не гарантия корректности самого вердикта — и применительно к домену, адресу и цене, которые вы указываете; он не наблюдает и не ограничивает адрес, на который вы в итоге проведёте расчёт. Используйте выделенный кошелёк, на котором лежит ровно столько, сколько вы намерены потратить.

• Ончейн-слой подписки/публикации/запросов (контракты BYTE Library + индексатор): тестовая сеть Arbitrum Sepolia (chain 421614), MockUSDC. Основная сеть для этого слоя открыта только после внешнего аудита безопасности. Домен подписи EIP-712-аттестации остаётся привязанным к 421614 независимо от того, по какому рельсу вы платили.

Один PRIVATE_KEY обслуживает оба рельса. Никогда не используйте повторно ключ, на котором лежат средства, которые вы не можете позволить себе потратить.

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

npx -y byte-mcp-server

Подключите его к вашему MCP-клиенту (конфиг Claude Desktop ниже), и ваш агент сможет:

• Находить потоки: «Перечисли каталог PayPerByte» / «Найди издателей по теме погода»

• Проверять контрагента перед оплатой (x402, без настройки): «Проверь этот домен и платёжный адрес перед расчётом» → $0.10 реального USDC в основной сети Base, подписанный вердикт ALLOW/WARN/BLOCK от Merchant Screen Oracle с квитанцией-аттестацией

• Сначала попробовать дёшево: «Дай погоду» / «Были землетрясения выше M4 сегодня?» → $0.005 / $0.003 реального USDC, та же квитанция-аттестация на каждом ответе — самый дешёвый способ увидеть работу проверки-перед-действием, прежде чем тратиться на вердикт

• Подписаться на поток (тестовая сеть): «Подпиши меня на поток землетрясений» → автоматическое одобрение MockUSDC для постоянных расчётов на Arbitrum Sepolia

• Запросить факт-оракул (тестовая сеть): отправить подписанный EIP-712-вопрос зарегистрированному издателю-факт-оракулу для получения ончейн-подписанного ответа с цитатами — когда издатель-факт-оракул активен (сегодня никто не вещает; инструмент истекает по таймауту, пока кто-то не зарегистрируется и не начнёт вещать)

Живой каталог — на x402.payperbyte.io/feeds — криптографически аттестованные, проверяемые по происхождению потоки по погоде, рынкам, коду, безопасности и знаниям.

Related MCP server: CorteX402

Проверка перед действием (ForeSeal)

Увидьте весь цикл проверки-перед-действием одной командой — без установки, без регистрации, без кошелька:

npx @foreseal/demo

Он выполняется локально (без реального USDC) и показывает, как агент ДЕЙСТВУЕТ на подлинных байтах и ОТКАЗЫВАЕТ четырём атакам — подменённому байту, подделанной подписи, отсутствующей квитанции, форкнутому домену подписи — примерно за секунду.

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

• Kit — @payperbyte/sdk: покупатель проверяет квитанцию перед действием.

• Gate — @foreseal/gate: продавец ставит проверяемую квитанцию на любой x402-эндпоинт.

Две парадигмы: подписка против покупки

Покупка — без настройки, оплата по мере использования, работает с реальными расчётами; подписка доставляет каждую трансляцию на слое тестовой сети, открытом после аудита. Выбирайте по паттерну доступа.

Покупка вердикта (POST-оракул)

GET-потокам данных нужен только feed. Любой поток, чей method включает POST (живой список: https://x402.payperbyte.io/feeds), принимает запрос как body — byte_buy_data автоматически переключает вызов с GET на POST. Оракулы вердиктов — потоки, возвращающие подписанный ALLOW/WARN/BLOCK, — это merchant-screen, address-reputation, sanctions-screen, pkg-verdict, reasoning-verdict:

// byte_buy_data tool call — screen a merchant/counterparty before settling
{
  "feed": "merchant-screen",
  "body": { "domain": "example.com", "address": "0x1234…abcd", "observed_price_atomic": "100000" }
}

Платный ответ возвращает подписанный вердикт и встроенный результат проверки-перед-действием по квитанции X-BYTE-Attestation:

{
  "feed": "merchant-screen",
  "paid": true,
  "price": "$0.100000",
  "txHash": "0x…",
  "data": { "answer": { "verdict": "ALLOW", "reasons": ["…"] }, "attestation": { "…": "…" } },
  "verification": { "verified": true, "hashMatch": true, "signerMatch": true,
                    "reason": "receipt verified — bytes intact AND signed by the pinned gateway attester (safe to act)" }
}

Действуйте только когда verification.verified === true — квитанция доказывает происхождение и целостность, а не корректность. Другие POST-тела: address-reputation {domain,address}, sanctions-screen {address|name}, pkg-verdict {ecosystem,package[,version]}, reasoning-verdict {subject}. Опустите body полностью для GET-потоков данных (погода, землетрясения, …).

Инструменты (всего 15)

Обнаружение (только чтение, без кошелька)

Подписка на поток (требуется PRIVATE_KEY)

Покупка по запросу (требуется PRIVATE_KEY)

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

Claude Desktop

Отредактируйте ~/.config/claude/claude_desktop_config.json (Linux) или ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{
  "mcpServers": {
    "payperbyte": {
      "command": "npx",
      "args": ["-y", "byte-mcp-server"],
      "env": {
        "PRIVATE_KEY": "0x...",
        "RPC_URL": "https://sepolia-rollup.arbitrum.io/rpc",
        "INDEXER_URL": "http://localhost:8080"
      }
    }
  }
}

PRIVATE_KEY необязателен — инструменты только для чтения работают без него. Добавьте его, чтобы включить subscribe, publish, buy и query.

Claude Code

claude mcp add payperbyte -- npx -y byte-mcp-server

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

Сеть

Два канала, честно говоря:

• Платёжный канал x402 (byte_buy_data): основная сеть Base (eip155:8453). Платные фиды расчитываются реальными USDC через шлюз на x402.payperbyte.io; каждый оплаченный ответ 200 возвращает квитанцию EIP-712 X-BYTE-Attestation, покрывающую точные байты ответа.

• Ончейн-слой (подписки, трансляции, эскроу факт-оракула, индексатор): Arbitrum Sepolia (цепочка 421614). Мейннет для контрактов BYTE Library откроется только после внешнего аудита безопасности. Домен подписи EIP-712 PayloadAttestation привязан к 421614 независимо от платёжного канала.

Адреса контрактов зафиксированы в поставляемой конфигурации; npm-релиз содержит готовые к использованию значения по умолчанию. Токена нет.

Разработка

git clone https://github.com/0rkz/byte-mcp-server.git
cd byte-mcp-server
npm install
npm run build && npm start

Лицензия

MIT — см. LICENSE.

Стартовый набор

Необязательный платный набор ($39): агентский набор для стороны покупателя — агент, который покупает и проверяет фиды, с готовой конфигурацией Claude Desktop / Claude Code / Cursor и бесплатным 30-минутным звонком для оценки готовности. npm-пакеты бесплатны и остаются бесплатными по MIT — набор продаёт готовую сборку.

Ссылки

• payperbyte.io — главная PayPerByte

• x402.payperbyte.io/feeds — каталог живых фидов

• Model Context Protocol — спецификация MCP

• MCP TypeScript SDK