Byte Protocol MCP Server

An MCP (Model Context Protocol) server that gives AI agents direct access to the Byte Protocol data marketplace on Arbitrum Sepolia.

⚠ Breaking change in 0.7.0 — v0.6 contract redeploy. The Byte Protocol v0.6 bundled redeploy went live on Arbitrum Sepolia (chain 421614) on 2026-05-20, and v0.5 is now paused. This release re-points the bundled default contract addresses to the v0.6 deployment: DataRegistry, DataStream, ReputationEngine, and the USDC token (now MockUSDC3009, EIP-3009-enabled) all changed. SchemaRegistry, PPBToken, and PQSVerifier are reused from v0.5 and unchanged. Any client pinned to 0.6.x keeps talking to the paused v0.5 contracts — upgrade to 0.7.0 to transact against the live v0.6 deployment.

Upgrading from 0.5.x? v0.6 adds EIP-712 signatures to byte_query_fact (closes the "spend someone else's escrow" attack — anyone could previously submit a query naming any subscriber's address and burn that subscriber's on-chain USDC escrow on an answer they never asked for). The fact-oracle server now requires every /query request to include a subscriber_signature that recovers to the claimed subscriber_address. Set PRIVATE_KEY in your env to the subscriber EOA; the MCP server signs each query automatically. Unsigned clients receive HTTP 401 with the EIP-712 domain echoed for debug.

What is MCP?

The Model Context Protocol is an open standard that lets AI assistants (like Claude) use external tools. This server exposes Byte Protocol's on-chain operations as MCP tools, so an AI agent can discover data publishers, check reputation scores, subscribe to feeds, and publish data -- all through natural language.

Tools

This server exposes 14 tools across read and write operations:

Read-only (no wallet required)

Write (require PRIVATE_KEY)

Installation

From npm (recommended)

npx -y byte-mcp-server

From source

git clone https://github.com/0rkz/byte-mcp-server.git
cd byte-mcp-server
npm install
npm run build
node dist/index.js

Configuration

Claude Desktop

Add this to your Claude Desktop config (~/.config/claude/claude_desktop_config.json on Linux, ~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "byte-protocol": {
      "command": "node",
      "args": ["/path/to/mcp-server/dist/index.js"],
      "env": {
        "RPC_URL": "https://sepolia-rollup.arbitrum.io/rpc",
        "INDEXER_URL": "http://localhost:8080"
      }
    }
  }
}

To enable write operations (subscribe, publish, faucet), add your private key:

{
  "mcpServers": {
    "byte-protocol": {
      "command": "node",
      "args": ["/path/to/mcp-server/dist/index.js"],
      "env": {
        "PRIVATE_KEY": "0x...",
        "RPC_URL": "https://sepolia-rollup.arbitrum.io/rpc",
        "INDEXER_URL": "http://localhost:8080"
      }
    }
  }
}

Claude Code

claude mcp add byte-protocol node /path/to/mcp-server/dist/index.js

Environment Variables

Usage

Once connected, your AI agent can do things like:

"Search for weather data publishers with a PQS score above 5000"

"What are the network stats for Byte Protocol?"

"Check the balance of 0xABC...123 on the testnet"

"Subscribe me to publisher 0xDEF...456"

"Register as a publisher for the topic eth-price with a 50 PPB stake"

"Get me some testnet tokens from the faucet"

Development

npm run dev    # Watch mode -- recompiles on changes
npm run build  # One-time build
npm start      # Run the server

Network

This server connects to Arbitrum Sepolia (chain ID 421614) by default. All contract addresses are for the testnet deployment.

License

MIT -- see LICENSE.

Links

• Byte Protocol

• Model Context Protocol

• MCP TypeScript SDK