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.

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 10 tools across read and write operations:

Read-only (no wallet required)

Tool	Description
`byte_search_publishers`	Search publishers by topic, minimum PQS score, and sort order
`byte_get_publisher`	Get detailed on-chain info for a publisher (status, tier, stake, PQS breakdown)
`byte_get_network_stats`	Get network-wide stats (total publishers, messages, fees, revenue)
`byte_check_subscription`	Check if an address is subscribed to a specific publisher
`byte_get_token_balances`	Get PPB, USDC, and ETH balances for any address
`byte_list_feeds`	List all active data feeds with pricing and quality scores

Write (require `PRIVATE_KEY`)

Tool	Description
`byte_drip_faucet`	Request 500 testnet PPB tokens (24h cooldown, 1000 PPB lifetime cap)
`byte_subscribe`	Subscribe to a publisher's data feed
`byte_register_publisher`	Register as a data publisher (schema + stake + on-chain registration)
`byte_publish_data`	Publish data to a subscriber via the DataStream contract

Installation

git clone https://github.com/byte-protocol/mcp-server.git
cd mcp-server
npm install
npm run build

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

Variable	Required	Default	Description
`PRIVATE_KEY`	No	--	Wallet private key for write operations. Without it, only read tools work.
`RPC_URL`	No	`https://sepolia-rollup.arbitrum.io/rpc`	Arbitrum Sepolia RPC endpoint
`INDEXER_URL`	No	`http://localhost:8080`	Byte Protocol indexer API URL

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.

byte-protocol