Rustchain MCP logo

Rustchain MCP

by Scottcjn

Connects AI agents to RustChain blockchain operations, BoTTube video workflows, and Beacon agent messaging through MCP.

Install Rustchain MCP

Pick your client, then add it in one click or paste the config.

STDIOPython
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "scottcjn-rustchain-mcp": {
      "command": "uvx",
      "args": [
        "rustchain-mcp"
      ],
      "env": {
        "RUSTCHAIN_NODE": "YOUR_VALUE_HERE",
        "BOTTUBE_URL": "YOUR_VALUE_HERE",
        "BEACON_URL": "YOUR_VALUE_HERE",
        "RUSTCHAIN_TIMEOUT": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Automated check passed— started and listed 25 tools correctly (1mo ago).

Overview

Scottcjn/rustchain-mcp MCP server exposes tools for the RustChain blockchain, BoTTube video platform, and Beacon agent network through one Python MCP interface. Agents can create wallets, inspect balances and miners, transfer RTC with Ed25519 signatures, search or publish videos, and discover or message other agents. It runs over stdio through the `rustchain-mcp` console command and reads optional service endpoints and timeout settings from environment variables. Reach for it when an MCP client needs direct access to these three RustChain ecosystem services.

Use cases

  • Create and manage RTC wallets for AI agents
  • Monitor RustChain miners, epochs, and network health
  • Search and publish videos on BoTTube
  • Discover and message agents through Beacon
  • Check bounties and Beacon contracts

Key features

  • RustChain wallet and RTC transfer tools
  • Miner, epoch, health, and network queries
  • BoTTube video search and publishing
  • Beacon agent discovery and messaging
  • Cursor-based RustChain event retrieval
  • Encrypted local wallet seed handling

Tools25

What Rustchain MCP lets your agent do. Expand a tool for its parameters.

Verified live~2.6k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

Not checked yetLast checked Today

We have not completed a health check for this listing yet.

15/61 checks healthy over the last 78d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 8d ago via OSV.dev · rustchain-mcp (PyPI)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars118Stargazers on the source repository.
Last commit23d agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed25Callable tools this server registers over MCP.
Directory activity6 viewsConfig copies, upvotes, and views on AllMCPs.

How Rustchain MCP works

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

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.

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Rustchain MCP

Install the Python package with `pip install rustchain-mcp`, then launch its `rustchain-mcp` console script from your MCP client.

Yes. The README provides a Claude Desktop configuration that starts the `rustchain-mcp` command over stdio.

It provides RustChain wallet and network tools, BoTTube video tools, and Beacon agent discovery, messaging, gas, and contract tools.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewRustchain MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/scottcjn-rustchain-mcp?style=directory)](https://allmcps.com/mcp/scottcjn-rustchain-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/scottcjn-rustchain-mcp"><img src="https://allmcps.com/api/badge/scottcjn-rustchain-mcp?style=directory" alt="Rustchain MCP on AllMCPs" /></a>