byte-mcp-server
About
Per-byte USDC data feeds + oracles for AI agents on Arbitrum. 14 tools, EIP-712 attested payloads, no API keys, no token. MCP server for the BYTE Library catalog (18+ first-party publishers).
Details
- Author
- 0rkz
- Downloads
- 285
- Categories
- Database, Other, Finance
- Tags
- #crypto, #defi, #evm, #data-analysis
Jump to
- Per‑byte USDC settlement on Arbitrum Sepolia testnet
- Verify‑before‑act: cryptographic data integrity check before trust
- 15 tools; 10 read‑only, 5 require a private key
- No API keys or tokens needed
- Every settlement emits an EIP‑712 PayloadAttestation as a cryptographic receipt
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
byte-mcp-serverCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install with npx -y byte-mcp-server. The server is also available on the Official MCP Registry as io.github.0rkz/byte-protocol. It exposes 15 tools: 10 are read‑only (e.g., discover publishers & feeds, network stats, subscription health, token balances, byte_query_fact, and the verify gate byte_verify_payload) and 5 require a PRIVATE_KEY (byte_subscribe, byte_unsubscribe, byte_register_publisher, byte_publish_data, byte_buy_data).
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"byte-mcp-server": {
"byte-library": {
"command": "npx",
"args": [
"-y",
"byte-mcp-server"
]
}
}
}
}McpServers
{
"byte-library": {
"command": "npx",
"args": [
"-y",
"byte-mcp-server"
]
}
}Two rails — read this before settingPRIVATE_KEY.
OnePRIVATE_KEYserves both rails. Never reuse a key holding funds you can't afford to spend.
Wire it into your MCP client (Claude Desktop config below), then your agent can:
The live catalog is atx402.payperbyte.io/feeds— cryptographically attested, provenance-verifiable feeds across weather, markets, code, security, and knowledge.
See the whole verify-before-act loop in one command — no install, no signup, no wallet:
It runs locally (no real USDC) and shows an agentACTon genuine bytes andREFUSEfour attacks — a tampered byte, a forged signature, a missing receipt, a forked signing domain — in about a second.
The same primitive ships as two packages you can drop into your own stack:
- Kit—@payperbyte/sdk: the buyer verifies a receipt before acting.
- Gate—@foreseal/gate: a seller stamps a verifiable receipt on any x402 endpoint.
GET data feeds need only afeed. Any feed whosemethodincludes POST (live list:https://x402.payperbyte.io/feeds) takes the query as abody—byte_buy_dataswitches the call from GET to POST automatically. Theverdict oracles— feeds that return a signed ALLOW/WARN/BLOCK — aremerchant-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" } }
The paid response returns the signed verdictandan inline verify-before-act result over theX-BYTE-Attestationreceipt:
{ "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)" } }
Act only whenverification.verified === true— the receipt proves provenance and integrity, not correctness. Other POST bodies:address-reputation {domain,address},sanctions-screen {address|name},pkg-verdict {ecosystem,package[,version]},reasoning-verdict {subject}. Omitbodyentirely for GET data feeds (weather, earthquakes, …).
Edit~/.config/claude/claude_desktop_config.json(Linux) or~/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" } } } }
claude mcp add payperbyte -- npx -y byte-mcp-server
- x402 payment rail (byte_buy_data): Base mainnet (eip155:8453).Paid feeds settle real USDC through the gateway atx402.payperbyte.io; each paid 200 returns anX-BYTE-AttestationEIP-712 receipt over the exact response bytes.
- On-chain layer (subscriptions, broadcasts, fact-oracle escrow, indexer): Arbitrum Sepolia (chain421614).Mainnet for the BYTE Library contracts is gated on an external security audit. The EIP-712PayloadAttestationsigning domain is anchored on421614regardless of the payment rail.
Contract addresses are pinned in the bundled config; the npm release ships ready-to-use defaults. No token.
git clone https://github.com/0rkz/byte-mcp-server.git cd byte-mcp-server npm install npm run build && npm start
Optional paid kit ($39): thebuyer-side agent kit— an agent that buys and verifies feeds, with drop-in Claude Desktop / Claude Code / Cursor config and a free 30-minute readiness call included. The npm packages are and stay free MIT — the kit sells the assembled setup.
- payperbyte.io— PayPerByte home
- x402.payperbyte.io/feeds— live feed catalog
- Model Context Protocol— MCP spec
- MCP TypeScript SDK
Access real-time DEX analytics across 20+ blockchains with DexPaprika API, tracking 5M+ tokens, pools, volumes, and historical market data. Built by CoinPaprika.
Interact with blockchain data using the Bankless API.
Real-time DeFi lending rates across 14+ protocols (Aave, Morpho, Spark, Compound, Venus, etc). Query borrow/supply rates, c ompare platforms, calculate looping strategies on 6 chains (Ethereum, Arbitrum, Base, BSC, Solana, HyperEVM).
Access blockchain transaction data in natural language, providing human-readable descriptions for AI assistants.
MCP to interface with multiple blockchains, staking, DeFi, swap, bridging, wallet management, DCA, Limit Orders, Coin Lookup, Tracking and more.
Bitcoin-native MCP server for AI agents: BTC/STX wallets, DeFi yield, sBTC peg, NFTs, and x402 payments.
Blockchain data across 100+ chains: token prices, NFTs, transfers, simulation, traces, Solana DAS
Live cross-DEX crypto prices read from on-chain pool state: per-venue price, liquidity depth and gross cross-venue spread across BSC, Polygon, Arbitrum, Base, Avalanche and Optimism. Works keyless, no account.
An AI gateway for the Blend Protocol on Stellar, enabling DeFi actions like lending, borrowing, and pool creation through AI assistants or apps.
MCP server for dry-run EVM transaction simulation via Crypto APIs
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
