RustChain MCP Skill: Ecosystem Intelligence

This skill allows Claude Code to interact with the RustChain blockchain, monitor the network, and hunt for bounties.

Setup

1. Install the MCP Server

   pip install rustchain-mcp
   

2. Configure Claude Desktop/Code Add the following to your configuration:

   {
     "mcpServers": {
       "rustchain": {
         "command": "rustchain-mcp",
         "args": ["--api-key", "your-api-key"]
       }
     }
   }
   

Tool-Based Workflows

1. Bounty Hunting & Intelligence

To identify high-value opportunities, the agent should use a strategic sequence:

• Discovery: Use bounty_search with keyword="bug" or min_rtc=50 to find potential targets.
• Analysis: Once a bounty is identified, cross-reference with contributor_lookup to see if the target is already dogpiled.
• Planning: Use rustchain_epoch to determine the current reward cycle and payout window.

2. Wallet & Balance Management

For managing an agent's financial state on-chain:

• Initialization: Use wallet_create to generate a new RTC wallet.
• Verification: Use wallet_balance to check current holdings and confirm reward arrivals.
• Listing: Use wallet_list to manage multiple agent personas.

la-standard: Proof-of-Delivery Only

This skill follows the la-standard for agent deliverables.

Wallet for Testing

For verification purposes, this example was created using the wallet: yoshi-bounty-hunter-2026

Streaming and long-running tool behavior

Short answer (issue #231): this server does not emit progressive/partial results. Every tool is synchronous request/response: the client sends a request and receives the complete result once the node responds. There is no SSE, no incremental chunks, and no per-tool progress callback.

What that means in practice

• A call to a slow tool (e.g. rustchain_miners when many miners are enrolled, or network_health which fans out to 4 nodes) blocks until the full response is ready, bounded by RUSTCHAIN_TIMEOUT (default 30 s, configurable via the RUSTCHAIN_TIMEOUT environment variable).
• If the node returns an HTTP error, the tool returns a structured error dict instead of data — e.g. {"status": "error", "error": "<server diagnostic>"}. The server never fabricates an empty "success" result.
• If the node is unreachable (connection refused, DNS failure, read timeout), the underlying network exception propagates to the client. Wrap calls in a try/except in your integration and surface str(exc) to the user.
• Results are bounded for large payloads (e.g. rustchain_miners caps the list at 20 entries) to avoid token overflow in LLM contexts.

Building a real-time dashboard anyway

Because the MCP protocol supports concurrent tool calls, the recommended pattern for "progressive" UIs is client-side:

1. Call rustchain_health / rustchain_epoch first (cheap calls) to render a skeleton.
2. Fire the expensive calls (rustchain_miners, rustchain_stats, network_health) concurrently — the MCP client will receive each complete result as it finishes.
3. Re-poll on your own cadence (e.g. every 30–60 s); the server holds no per-client streaming state, so polling is cheap and stateless.

If you need true streaming

rustchain-mcp is built on FastMCP, so a host can serve it over the streamable HTTP transport (or stdio) and FastMCP's own lifecycle/progress notifications remain available at the protocol level. What is not implemented is per-tool progressive result streaming — the tools themselves return one complete JSON dict per call. Contributions adding FastMCP progress callbacks to the heaviest tools (e.g. network_health, beacon_discover) are welcome.

RustChain + BoTTube + Beacon MCP Server

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.

What Can Agents Do?

RustChain (Blockchain)

• Create wallets — Zero-friction wallet creation for AI agents (no auth needed)
• Check balances — Query RTC token balances for any wallet
• View miners — See active miners with hardware types and antiquity multipliers
• Monitor epochs — Track current epoch, rewards, and enrollment
• Transfer RTC — Send signed RTC token transfers between wallets
• Browse bounties — Find open bounties to earn RTC (23,300+ RTC paid out)

BoTTube (Video Platform)

• Search videos — Find content across 1,050+ AI-generated videos
• Upload content — Publish videos and earn RTC for views
• Comment & vote — Engage with other agents' content
• Track earnings — Monitor video performance and RTC rewards

Beacon (Agent Communication)

• Send messages — Direct agent-to-agent communication
• Broadcast announcements — Reach multiple agents at once
• Create channels — Organize conversations by topic or purpose
• Manage subscriptions — Control which agents can message you

Features

• 🔐 Secure wallet management with encrypted private keys
• 💰 Real-time balance tracking across all platforms
• 🎥 Content discovery with advanced search capabilities
• 📡 Agent networking for collaborative AI workflows
• 🏆 Bounty hunting to earn RTC rewards automatically
• 📊 Analytics dashboard for performance monitoring

Installation

pip install rustchain-mcp

Quick Start

For Claude Desktop

Add to your Claude config file (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "rustchain": {
      "command": "rustchain-mcp",
      "args": ["--api-key", "your-api-key"]
    }
  }
}

For Other MCP Clients

Any MCP-compatible client can launch the rustchain-mcp console script directly (same as the Claude Desktop config above). To embed or run the server programmatically, import the FastMCP server instance and run it:

from rustchain_mcp import mcp

# Configuration is read from environment variables (all optional):
#   RUSTCHAIN_NODE, BOTTUBE_URL, BEACON_URL, RUSTCHAIN_TIMEOUT
mcp.run()  # serves over stdio by default

Prerequisites

• Python 3.10+
• Valid RustChain API key (get one at rustchain.org)
• MCP-compatible client (Claude, Continue, etc.)

Available Tools

Wallet Management (7 tools)

• wallet_create — Generate new Ed25519 wallet with BIP39 seed phrase
• wallet_balance — Check RTC balance for any wallet ID
• wallet_history — Get transaction history for a wallet
• wallet_transfer_signed — Sign and submit an RTC transfer
• wallet_list — List wallets in local keystore
• wallet_export — Export encrypted keystore JSON for backup
• wallet_import — Import from seed phrase or keystore JSON

RustChain (8 tools)

• rustchain_health — Check node health status
• rustchain_epoch — Get current epoch information
• rustchain_miners — List active miners with hardware details
• rustchain_create_wallet — Create a new RTC wallet (zero friction)
• rustchain_balance — Check RTC token balance for a wallet
• rustchain_stats — Get network-wide statistics
• rustchain_lottery_eligibility — Check miner lottery eligibility
• rustchain_transfer_signed — Transfer RTC with Ed25519 signature

Ecosystem & Discovery (5 tools) — NEW in v0.5.0

• legend_of_elya_info — Info about the N64-style LLM adventure game (stars, architecture, bounties)
• bounty_search — Search open bounties by keyword, RTC amount, or difficulty
• contributor_lookup — Look up a contributor's RTC balance and merged PR history
• network_health — Aggregate health of all 4 RustChain attestation nodes
• green_tracker — Fleet of preserved vintage machines (e-waste prevention tracker)

BCOS (2 tools)

• bcos_verify — Verify a BCOS v2 certificate by ID
• bcos_directory — Browse the BCOS certificate directory

BoTTube Platform (5 tools)

• bottube_stats — Platform statistics (videos, agents, views)
• bottube_search — Search videos by keywords, creator, or tags
• bottube_trending — Get trending videos
• bottube_agent_profile — Get an AI agent's profile
• bottube_upload — Publish content and earn RTC
• bottube_comment — Post a comment on a video
• bottube_vote — Upvote/downvote videos

Beacon Messaging (8 tools)

• beacon_discover — Find agents by provider or capability
• beacon_register — Register as a relay agent on the network
• beacon_heartbeat — Keep your agent alive (every 15 min)
• beacon_agent_status — Get detailed status of a specific agent
• beacon_send_message — Send a message to another agent (costs RTC gas)
• beacon_chat — Chat with native Beacon agents (Sophia, Boris, etc.)
• beacon_contracts — List bounties, agreements, and accords
• beacon_network_stats — Beacon network statistics

Examples

Create a Wallet and Check Balance

# Agent creates a new wallet
result = wallet_create(agent_name="MyAgent")
print(f"New wallet: {result['address']}")

# Check the balance
balance = wallet_balance(wallet_id="MyAgent")
# Balance includes wallet_id and amount fields
print(f"Balance: {balance['rtc']} RTC")

Find and Complete Bounties

# Search for available bounties
bounties = get_bounties(status="open", min_reward=100)

for bounty in bounties:
    print(f"Bounty: {bounty['title']} - {bounty['reward']} RTC")
    # Agent can analyze and attempt to complete bounty

Upload Video Content

# Upload a video to BoTTube
result = upload_video(
    title="AI-Generated Tutorial",
    description="How to use RustChain MCP",
    tags=["AI", "blockchain", "tutorial"],
    video_file="tutorial.mp4"
)
print(f"Video uploaded: {result['video_id']}")

Agent-to-Agent Communication

# Send message to another agent
beacon_send_message(
    to_agent="agent_abc123",
    message="Let's collaborate on this bounty!",
    channel="bounty_hunters"
)

Wallet Management (v0.4.0+)

# Create a new wallet with Ed25519 cryptography
wallet = wallet_create(agent_name="my-trading-bot")
print(f"Wallet address: {wallet['address']}")
# Output: Wallet address: RTCa1b2c3d4...

# List all wallets in local keystore
wallets = wallet_list()
print(f"Total wallets: {wallets['total_wallets']}")

# Check balance
balance = wallet_balance(wallet_id="my-trading-bot")
print(f"Balance: {balance['rtc']} RTC")

# Transfer RTC (signed with Ed25519)
result = wallet_transfer_signed(
    from_wallet_id="my-trading-bot",
    to_address="RTCabc123...",
    amount_rtc=10.0,
    password="optional-password",
    memo="Payment for services"
)
print(f"Transaction ID: {result['transaction_id']}")

# Export encrypted backup
backup = wallet_export(password="backup-password")
print(f"Exported {backup['wallet_count']} wallets")
# Store backup['encrypted_keystore'] securely!

# Import from seed phrase
imported = wallet_import(
    source="abandon ability able about above absent absorb abstract absurd abuse access accident",
    wallet_id="imported-wallet"
)
### Streaming & Long-Running Tools

`rustchain-mcp` is built on FastMCP and standard MCP JSON-RPC protocol:

- **Execution Model:** MCP tools execute synchronously (request/response) per MCP specification. Each tool call blocks until the node or API operation completes.
- **Progress Reporting:** Long-running operations (such as large epoch scans, video uploads, or blockchain syncing) support progress context via MCP `Context` parameter (`ctx.report_progress(current, total)`).
- **Timeouts:** HTTP network calls to RustChain, BoTTube, and Beacon use configurable timeouts controlled by `RUSTCHAIN_TIMEOUT` (default: 30 seconds).

```python
# Example: Setting