Каталог MCP
0rkz/byte-mcp-server

0rkz/byte-mcp-server

Name: 0rkz/byte-mcp-server
Availability: InStock
Author: 0rkz

MCP сервер PayPerByte даёт AI агентам доступ к верифицированным фидам данных с оплатой за вызов (x402) в USDC на Base mainnet или подпиской на Arbitrum Sepolia. Покупка пакетов данных с EIP-712 атт...

README

15 инструментов

Версии

Установить сервер

PayPerByte MCP Server

A Model Context Protocol server that gives AI agents direct access to PayPerByte — verified, provenance-first data feeds for AI agents. Agents discover feeds, pay-per-call via x402 (settled in USDC on Base mainnet), or subscribe to on-chain streams (Arbitrum Sepolia testnet). Every paid x402 response carries an EIP-712 PayloadAttestation receipt (X-BYTE-Attestation header) the agent verifies before acting. No tokens, no API keys, no off-chain accounts.

Two rails — read this before setting PRIVATE_KEY.

x402 pay-per-call (byte_buy_data): Base mainnet (eip155:8453), REAL USDC. Paid feeds settle real money — the flagship Address Reputation Oracle is $0.05 per verdict. Use a dedicated wallet holding only what you intend to spend.

On-chain subscribe/publish/query layer (BYTE Library contracts + indexer): Arbitrum Sepolia testnet (chain 421614), MockUSDC. Mainnet for this layer is gated on an external security audit. The EIP-712 attestation signing domain stays anchored at 421614 regardless of which rail you paid on.

One PRIVATE_KEY serves both rails. Never reuse a key holding funds you can't afford to spend.

Инструменты были проиндексированы: 11.09.2026

byte_buy_dataвнешний мир

Покупает один пакет данных из любого фида PayPerByte через платёжный шлюз x402. Без подписки, без лимита, без предварительной настройки в блокчейне — расчёт USDC за каждый вызов. MCP-сервер подписывает EIP-3009 transferWithAuthorization от имени кошелька, для которого задан PRIVATE_KEY, фасилитатор x402 отправляет транзакцию, а данные возвращаются вместе с хешем транзакции расчёта в блокчейне. Используйте byte_subscribe, если нужен непрерывный поток трансляций от издателя. Каталог доступных слогов фидов находится по адресу https://x402.payperbyte.io/feeds (бесплатный GET). GET-фиды данных (погода, землетрясения, …) требуют только feed; 10 POST-оракулов — runtime-eol, threat-intel, address-reputation, pkg-verdict, sanctions-screen, reasoning-verdict, merchant-screen, positioning-snapshot, cctp-attestation-latency, regime-signal — дополнительно требуют JSON-body (запрос) — передача body переключает этот вызов на POST. Требует переменную окружения PRIVATE_KEY на MCP-сервере и USDC на настроенном кошельке. ВАЖНО: платные фиды расходуют НАСТОЯЩИЕ USDC в основной сети Base (eip155:8453) — точная цена указывается в 402-челлендже (флагманский merchant-screen: $0.10 за вердикт — предрасчётный экран контрагента; подписанное EIP-712 подтверждение точных байтов ответа доказывает доставку, а не корректность самого вердикта). Используйте отдельный кошелёк с суммой, которую готовы потратить.

Параметры

bodyobject
Optional JSON query body for POST oracles. Supplying it switches the call from GET to POST. Required by the verdict oracles, e.g. address-reputation {domain,address[,amount,chain]}, sanctions-screen {address|name}, pkg-verdict {ecosystem,package[,version]}, reasoning-verdict {subject}. Omit for GET data feeds (weather, earthquakes, …).
feedstringобязательный
Feed slug — one of: weather ($0.0050), earthquakes ($0.0030), runtime-eol ($0.020), threat-intel ($0.050), address-reputation ($0.100), pkg-verdict ($0.100), sanctions-screen ($0.100), reasoning-verdict ($0.100), merchant-screen ($0.100), positioning-snapshot ($0.030), cctp-attestation-latency ($0.010), regime-signal ($0.020). Full catalog: https://x402.payperbyte.io/feeds (free GET). (For fact-oracle Q&A use byte_query_fact instead — it uses a different request-response flow.)

byte_check_subscriptionтолько чтениеидемпотентныйвнешний мир

Проверяет, подписан ли адрес на конкретного издателя в PayPerByte.

Параметры

publisherstringобязательный
Publisher Ethereum address (0x...)
subscriberstringобязательный
Subscriber Ethereum address (0x...)

byte_get_network_statsтолько чтениеидемпотентныйвнешний мир

Получить статистику по всей сети PayPerByte: общее количество издателей, переданных сообщений и общая сумма комиссий подписчиков, выплаченных в USDC.

Параметры

Без параметров.

byte_get_publisherтолько чтениеидемпотентныйвнешний мир

Получить ончейн-информацию для конкретного издателя PayPerByte: статус, количество подписчиков и сообщений, доход в USDC и зарегистрированную схему (ограничения по размеру, каденцию, цену за КБ).

Параметры

addressstringобязательный
Publisher Ethereum address (0x...)

byte_get_token_balancesтолько чтениеидемпотентныйвнешний мир

Получает балансы USDC и ETH для адреса на Arbitrum Sepolia (ончейн-тестнет — MockUSDC выполняет расчёты по подпискам и запросам факт-оракула там). НЕ показывает баланс USDC в Base-mainnet, который расходует byte_buy_data.

Параметры

addressstringобязательный
Ethereum address (0x...)

byte_list_feedsтолько чтениеидемпотентныйвнешний мир

Перечисли все активные потоки данных в каталоге PayPerByte с темами, ценой за КБ и частотой.

Параметры

Без параметров.

byte_list_my_subscriptionsтолько чтениеидемпотентныйвнешний мир

Выводит все активные подписки для указанного адреса кошелька. Каждая запись содержит адрес издателя, тему, статус, дату подписки, количество полученных сообщений за 7/30 дней, потраченные USDC за 7/30 дней и время последнего полученного сообщения. Используйте эту информацию, чтобы увидеть, за что вы сейчас платите, и решить, стоит ли отписаться.

Параметры

indexerUrlstring
Optional indexer URL override (default: INDEXER_URL/BYTE_INDEXER_URL env or https://feeds.payperbyte.io)
subscriberstringобязательный
Wallet address to list subscriptions for

byte_publish_dataвнешний мир

Публикует данные подписчику через контракт PayPerByte DataStream. Хеширует полезную нагрузку, записывает размер в цепочку и проводит оплату в USDC. Требуется PRIVATE_KEY.

Параметры

datastringобязательный
Data payload to publish (will be hashed on-chain)
maxFeenumberобязательный
Maximum fee in USDC willing to pay for this publish (e.g. 0.05)
subscriberstringобязательный
Subscriber Ethereum address (0x...)

byte_query_factвнешний мир

Запрашивает у издателя fact-oracle PayPerByte подписанный ответ с цитатами. Отправляет вопрос зарегистрированному издателю fact-oracle (topic='fact-oracle'), ожидает ответа в формате BroadcastStreamed в блокчейне и возвращает ответ вместе с URL-адресами структурированных цитат. Подписанная квитанция подтверждает, какой издатель предоставил ответ (происхождение + защита от подделки), НО НЕ то, что ответ верен: опирайтесь в выводе на цитируемые источники, а не на гарантию истинности. Доступность: для этого требуется активная трансляция зарегистрированного издателя fact-oracle; если ни один из них не работает, вызов возвращает тайм-аут, а не ответ.

Параметры

max_byte_costnumber
Max response payload bytes you're willing to pay for (defaults to 2000, ≈$1 at $0.0005/byte). Publisher refuses if can't fit answer.
max_response_latency_msnumber
Max time to wait for the publisher's broadcast (default 30000 ms). Local-LLM publishers (Ollama + Searxng + 3-sample NLI gate) take ~30-60s; Anthropic + passthrough takes ~10-20s. Hard ceiling 180s.
min_publisher_pqsnumber
Minimum PQS to consider (BPS scale, 0-10000). 9000 = Elite-only, 7500 = Premium+.
questionstringобязательный
The factual question to ask (e.g. 'What was last night's Lakers vs Warriors score?'). Should be specific and verifiable.
subscriber_addressstringобязательный
Your wallet address. You MUST be subscribed to the chosen publisher (with sufficient USDC escrow) or the publisher's on-chain broadcast will be skipped.
topic_filterstring
Optional topic filter (e.g. 'fact-oracle' default; future: 'sports', 'finance').

byte_register_publisherвнешний мир

Регистрация в качестве издателя данных на PayPerByte. Регистрирует схему и издателя в блокчейне. Требуется PRIVATE_KEY. Издатели PayPerByte v1 являются собственной стороной и не делают стейк — оставьте долю на '0'; ненулевой стейк в USDC сначала одобряется в DataRegistry, если вы решите его внести.

Параметры

expectedSizenumberобязательный
Expected payload size in bytes per message
frequencynumberобязательный
Expected publishing frequency in seconds
maxSizenumberобязательный
Maximum payload size in bytes per message
pricePerKBnumberобязательный
Price per kilobyte in USDC (e.g. 0.003)
stakestringобязательный
USDC reputation stake to post, as a decimal string. Default '0' — PayPerByte v1 publishers are unstaked.
topicstringобязательный
Data feed topic (e.g. 'eth-price', 'weather-nyc', 'gas-tracker')

byte_search_publishersтолько чтениеидемпотентныйвнешний мир

Ищет издателей PayPerByte по теме и порядку сортировки. Возвращает адреса издателей, темы, количество подписчиков, количество сообщений и цену за килобайт.

Параметры

limitnumber
Max results to return (default 20)
querystring
Topic keyword to search (e.g. 'weather', 'crypto', 'cve')
sortBystring
Sort field: 'subscribers', 'revenue', 'messages'

byte_subscribeвнешний мир

Подписывается на поток данных издателя PayPerByte. По умолчанию также устанавливает разрешение USDC для DataStreamLib на type(uint256).max, чтобы подписка не теряла платежи незаметно, когда запас расходуется (контракт пропускает проверку разрешения и генерирует DataStreamed с amount=0 при ошибке transferFrom, а не откатывает транзакцию). Передайте skipAllowance: true, чтобы отказаться и установить конечный лимит вручную. Требуется PRIVATE_KEY.

Параметры

publisherstringобязательный
Publisher Ethereum address (0x...) to subscribe to
skipAllowanceboolean
If true, don't bundle the USDC approve(max) call. Default false. Auto-approve is also skipped when the wallet already has ≥ $1000 USDC of allowance to DataStreamLib.

byte_subscription_healthтолько чтениеидемпотентныйвнешний мир

Получает сигнал content-drift для издателя. Сравнивает их последние 7 дней публикационной активности (частота, количество сообщений) с 23-дневным базовым периодом (дни 8-30). Возвращает 'stable' (стабильная публикация), 'moderate' (сдвиг частоты на 20-50% или тишина 24-48 ч), 'significant' (сдвиг более 50% или тишина более 48 ч) или 'unknown' (новый издатель, недостаточно базовых данных). Используйте это, чтобы определить, когда издатель, на которого вы подписаны, сменил тематику или перестал публиковать.

Параметры

indexerUrlstring
Optional indexer URL override
publisherstringобязательный
Publisher address to check

byte_unsubscribeвнешний мир

Отписка от фида данных издателя. Вступает в силу со следующим блоком: списания прекращаются, поток данных останавливается. Обратимо – вы можете повторно подписаться позже через byte_subscribe. Используйте эту функцию, если издатель изменил направление контента (сначала проверьте через byte_subscription_health) или если вы просто больше не хотите получать этот фид. Требуется PRIVATE_KEY для подключённого кошелька.

Параметры

publisherstringобязательный
Publisher address to unsubscribe from

byte_verify_payloadтолько чтениеидемпотентныйвнешний мир

Verify-before-act: убедитесь, что полезные данные (data payload), с которыми агент собирается работать, действительно соответствуют тому, что издатель криптографически засвидетельствовал в цепочке. Пересчитывает keccak256 полученных байтов и сравнивает его с хешем EIP-712 PayloadAttestation в цепочке. ВСЕГДА вызывайте это для данных, полученных из BYTE, перед тем как с ними работать; если verified=false - байты были подделаны/повреждены при передаче и НЕ ДОЛЖНЫ использоваться. Привязывайте проверку к ЛИБО expectedHash (payloadHash в цепочке, который у вас уже есть, например из byte_query_fact / byte_buy_data), ЛИБО txHash (транзакция расчёта - также восстанавливает подписавшего аттестацию и подтверждает, что это указанный издатель). Read-only; кошелёк или платёж не требуется.

Параметры

datastringобязательный
The exact payload bytes the agent received and is about to act on — the raw delivered string, or a 0x-prefixed hex byte string.
expectedHashstring
On-chain payloadHash to verify against (0x + 64 hex), e.g. the payloadHash returned by byte_query_fact or byte_buy_data.
hashModeenum
How to hash structured payloads: 'raw' (keccak of the utf8 string, default — matches byte_publish_data) or 'canonical' (keccak of key-sorted, whitespace-free JSON).
txHashstring
Settlement tx hash whose on-chain BroadcastStreamed attestation to verify against. When provided, also recovers the EIP-712 signer and confirms it is the attesting publisher.

Github Сайт сервера

Конфиг для установки сервера

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

Нужен npx

Сервер запускается через npx
Без него ничего работать не будет.

Как установить npx

Информация о сервере

Номер в рейтинге: #198
Звезд на Github: 1
Форков на Github: 0
Загрузок: 9 722
Язык реализации: TypeScript
Лицензия: MIT
Официальный сервер: Нет
Дата обновления данных: 10.09 в 22:03
Идентификатор: Gu_xJ1LeMwKO9wYT
Категории: Web3 и децентрализованные технологии, Агенты, Блокчейн, ИИ и машинное обучение, Поиск, Финансы