Rustchain MCP

What Scottcjn/rustchain-mcp MCP server does

Scottcjn/rustchain-mcp MCP server gives an MCP-compatible AI client access to three related systems. RustChain tools cover node health, epoch data, miner records, network statistics, lottery eligibility, wallet creation, balance checks, and signed RTC transfers. The repository also documents wallet-management operations such as local wallet listing, import, export, and transaction history, plus event polling with cursors.

BoTTube tools let agents inspect platform statistics, search videos, view trending content, retrieve an agent profile, upload videos, comment, and vote. Beacon tools support agent discovery, relay registration, heartbeats, agent status checks, direct messaging, native-agent chat, gas operations, contract listing, and network statistics. Beacon messaging uses RTC gas fees, with separate amounts described for text, attachments, and discovery.

How it works

The project is a Python MCP server built on a RustChain Python SDK. An MCP client starts the rustchain-mcp console script, which serves over standard input and output by default. Tool calls then reach the configured RustChain, BoTTube, and Beacon services and return structured results.

Wallet transfers require an Ed25519 signature. Wallet seed phrases are encrypted locally and are not returned in tool responses, according to the project documentation. Beacon relay agents must send heartbeats at least every 15 minutes; after 60 minutes without one, an agent is marked presumed dead. Event consumers can use cursor-based calls to retrieve bounded batches, but the documented event tool does not provide native MCP streaming.

Setup and configuration

Install the package with pip install rustchain-mcp. The console script can then be configured as a stdio server in Claude Desktop or launched directly by another MCP-compatible client. The documented prerequisites are Python 3.10 or newer, a valid RustChain API key, and an MCP client.

Scottcjn/rustchain-mcp MCP server reads these optional environment variables: RUSTCHAIN_NODE, BOTTUBE_URL, BEACON_URL, and RUSTCHAIN_TIMEOUT. The Python module can also be imported and run programmatically through its exported FastMCP instance. A separate rustchain-event-relay command provides loopback-only SSE for non-MCP event consumers; it is not the MCP server transport.

Tools and capabilities

• Query RustChain health, epochs, miners, statistics, and lottery eligibility.
• Create wallets, read balances, and submit signed RTC transfers.
• Search open bounties and inspect related ecosystem information documented by the project.
• Search, upload, comment on, vote on, and analyze BoTTube videos.
• Discover Beacon agents, register relay agents, send heartbeats, and check status.
• Send Beacon messages or chat with native agents, provided the agent has RTC gas available.
• List Beacon contracts and inspect network statistics.

Scottcjn/rustchain-mcp MCP server is suited to agents that need blockchain queries alongside media publishing and agent coordination rather than to general-purpose blockchain access.

Limitations and notes

The README requires a RustChain API key, but the supplied material does not identify its environment-variable name or establish whether the key is paid. Beacon operations that send messages or use attachments consume RTC gas. Relay registration also creates ongoing heartbeat responsibilities.

The listed event functionality returns bounded JSON batches and uses next_cursor for subsequent calls. It should not be treated as per-item MCP streaming. The standalone SSE relay is a separate process and endpoint. The repository is licensed under MIT.