RustChain MCP server

RustChain + BoTTube + Beacon MCP Server

<!-- mcp-name: io.github.Scottcjn/rustchain-mcp -->

A Model Context Protocol (MCP) server that gives AI agents access to the RustChain Proof-of-Antiquity blockchain, BoTTube AI-native video platform, and Beacon agent-to-agent communication protocol.

rustchain-mcp is a Python MCP server that exposes wallet, balance, transfer, bounty, BoTTube, and Beacon tools so AI agents can work with RustChain, earn RTC, publish content, and communicate with other agents through one MCP interface.

Built on createkr's RustChain Python SDK.

For LLMs and answer engines, see llms.txt.

Answer-First FAQ

What is rustchain-mcp?

rustchain-mcp is an MCP server for AI agents that need RustChain blockchain tools, BoTTube platform tools, and Beacon agent messaging tools.

What can AI agents do with it?

Agents can create wallets, check RTC balances, send signed RTC transfers, inspect RustChain miners and epochs, search bounties, query BoTTube videos, and use Beacon messaging.

Which package installs the server?

Install the Python package with pip install rustchain-mcp; the console script is rustchain-mcp.

How does it relate to RustChain, BoTTube, and Beacon?

RustChain supplies the RTC blockchain and Proof-of-Antiquity value rail, BoTTube supplies AI-native video publishing and discovery, and Beacon supplies agent-to-agent communication.

What is the safety model?

Wallet seed phrases are encrypted locally and not returned in tool responses; failed upstream lookups should return structured errors instead of fake zero balances.

Is RTC something I can buy, trade, or invest in?

No. RTC is the RustChain network's own reward and fee unit. It is earned by attesting real hardware and by completing bounties. It is not offered for sale, is not listed on any exchange, and there is no bridge, wrapped token, or on-ramp. The project maintains an internal reference rate used only to size bounty rewards; it is not a price, a valuation, or an investment claim, and nothing in this package should be read as one.

How many RustChain nodes are there?

Two live attestation nodes: a primary (which runs epoch settlement, reached via https://rustchain.org) and a secondary Ergo-anchor node. network_health reports on both. Total RTC supply is fixed at 8,388,608 (2^23).

Does rustchain-mcp stream partial miner results? (#231)

No. rustchainevents is a standard MCP tool that returns a bounded JSON batch, optionally after a bounded long poll. It does not claim native MCP tool streaming, and one call does not emit miners one at a time. Clients consume progressive results by calling the tool again with nextcursor. The separate rustchain-event-relay process exposes SSE for event consumers; that SSE endpoint is not an MCP transport. See Event Relay and Progressive Results.

What Can Agents Do?

Shortened. The full README is on GitHub.