Log inSubmit server
Byte MCP Server logo

Byte MCP Server

by 0rkz

Connects AI agents to PayPerByte feeds for discovery, USDC payments, subscriptions, publishing, and payload verification.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Byte MCP Server

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "0rkz-byte-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "byte-mcp-server"
      ],
      "env": {
        "PRIVATE_KEY": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Automated check passed— started and listed 15 tools correctly (1mo ago).

Overview

The 0rkz/byte-mcp-server MCP server connects AI agents to PayPerByte data feeds and on-chain publisher records. It supports feed discovery, publisher and subscription inspection, Arbitrum Sepolia subscriptions, Base mainnet x402 purchases, data publishing, fact-oracle queries, and cryptographic payload checks. Read-only discovery tools need no credentials, while subscription, publishing, querying, and buying require a configured PRIVATE_KEY. Reach for it when an agent needs paid data access with settlement details and verify-before-act checks.

Use cases

  • Discover data publishers by topic and price
  • Buy a one-off feed packet with x402
  • Subscribe to recurring testnet data streams
  • Verify payload integrity before acting
  • Publish data to subscribed wallets

Key features

  • PayPerByte publisher and feed discovery
  • x402 pay-per-call USDC purchases
  • Arbitrum Sepolia stream subscriptions
  • Publisher registration and data publishing
  • Fact-oracle queries with citations
  • On-chain payload attestation verification

Tools15

What Byte MCP Server lets your agent do. Expand a tool for its parameters.

Verified live~3.2k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 2d ago

Recent health check succeeded.

49/49 checks healthy over the last 88d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 16d ago via OSV.dev · byte-mcp-server (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars1Stargazers on the source repository.
npm downloads459Package downloads in the last 30 days.
Last commit4d agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed15Callable tools this server registers over MCP.
Directory activity8 viewsConfig copies, upvotes, and views on AllMCPs.

How Byte MCP Server works

What 0rkz/byte-mcp-server MCP server does

The 0rkz/byte-mcp-server MCP server exposes PayPerByte marketplace and data-stream operations through MCP tools. Agents can search publishers, browse active feeds, inspect network statistics, review publisher schemas, and check subscription state. The available catalog includes feeds across areas such as weather, markets, code, security, and knowledge, with topic, frequency, and price-per-KB metadata.

The server supports two payment paths. byte_buy_data makes a one-off request through the x402 gateway and settles real USDC on Base mainnet. byte_subscribe enables recurring stream delivery on the Arbitrum Sepolia testnet using MockUSDC. Subscription tools also cover unsubscribing, listing wallet subscriptions, and checking whether a publisher's activity has materially changed.

How it works

Read-only tools query PayPerByte catalog, indexer, and on-chain information without a wallet. A configured wallet is needed for actions that spend funds or write to contracts, including subscribing, unsubscribing, registering a publisher, publishing data, querying the fact oracle, and buying a feed packet.

The two rails use different networks. One-off x402 purchases use Base mainnet, chain eip155:8453, and real USDC. Subscription, publishing, and fact-oracle operations use BYTE Library contracts on Arbitrum Sepolia, chain 421614, with MockUSDC. The same PRIVATE_KEY can serve both paths, so it should belong to a dedicated wallet containing only funds intended for these operations.

Paid responses include an EIP-712 PayloadAttestation receipt. byte_verify_payload recomputes the received bytes' keccak256 hash and compares it with an on-chain attestation. Verification establishes delivery integrity and the attested signer relationship; it does not establish that the publisher's data is factually correct. The tool can use an expected payload hash or a settlement transaction hash as its anchor.

Setup and configuration

Start the 0rkz/byte-mcp-server MCP server with:

Terminal
npx -y byte-mcp-server

The README includes Claude Desktop wiring instructions. No API key is required. Set PRIVATE_KEY on the server when using wallet-backed operations. Buying data also requires USDC on the configured wallet; those purchases settle real USDC on Base mainnet. Subscription and related testnet operations use the Arbitrum Sepolia layer and its MockUSDC balances.

The live x402 feed catalog is available from https://x402.payperbyte.io/feeds. GET feeds take a feed slug, while POST oracle feeds take a JSON body; providing body causes byte_buy_data to use POST. The README advises keeping the wallet isolated because paid calls spend real funds.

Tools and capabilities

Discovery and inspection capabilities include:

  • Search publishers by topic and sort order.
  • List active feeds with topics, prices, and frequencies.
  • Inspect publisher status, schema, subscriber count, message count, and USDC revenue.
  • Read network totals and wallet token balances on Arbitrum Sepolia.
  • List subscriptions and review recent message delivery and USDC spending.
  • Classify subscription activity as stable, moderate, significant, or unknown.

Wallet-backed capabilities include subscribing, unsubscribing, registering a first-party publisher, and publishing payloads through the DataStream contract. byte_query_fact asks a registered fact-oracle publisher for a signed answer with citation URLs, but it times out if no suitable publisher is actively broadcasting. byte_buy_data returns the purchased data and settlement transaction hash inline.

Limitations and notes

Arbitrum Sepolia subscription and publishing functionality is testnet-based, while x402 buying uses real Base-mainnet USDC. The fact-oracle response is not a truth guarantee, and attestation verification does not validate the correctness of the underlying content. Before acting on BYTE-sourced bytes, use byte_verify_payload; a failed verification means the bytes should not be used.

The server does not display the Base-mainnet USDC balance spent by byte_buy_data when using its Arbitrum Sepolia balance tool.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Byte MCP Server

Run `npx -y byte-mcp-server`. The README also provides Claude Desktop configuration guidance.

No API key is required. Wallet-backed operations require the server's `PRIVATE_KEY` environment variable.

Yes. The README includes Claude Desktop wiring instructions.

Yes for `byte_buy_data`, which settles on Base mainnet. Subscription and publishing operations use MockUSDC on Arbitrum Sepolia.

Call `byte_verify_payload` with an expected on-chain payload hash or a settlement transaction hash. It checks the received bytes against the EIP-712 payload attestation.

Related MCP servers

All in Finance & Fintech All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewByte MCP Server AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/0rkz-byte-mcp-server?style=directory)](https://allmcps.com/mcp/0rkz-byte-mcp-server)
HTML Embed
<a href="https://allmcps.com/mcp/0rkz-byte-mcp-server"><img src="https://allmcps.com/api/badge/0rkz-byte-mcp-server?style=directory" alt="Byte MCP Server on AllMCPs" /></a>