rustchain-mcpBLOCK
MCP server for autonomous agent economies: wallets, signed RTC micropayments, bounty discovery, BoTTube video publishing, and Beacon agent-to-agent messaging. Give your AI agent an income. Built on createkr's RustChain SDK.
Overview
From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.
[](https://mseep.ai/app/scottcjn-rustchain-mcp)
[](https://github.com/Scottcjn/Rustchain) [](https://pypi.org/project/rustchain-mcp/) [](https://opensource.org/licenses/MIT)
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.
Wh
51e68cf9aaf2OBSERVED · 2026-09-26Connect
Built from this server's own package name, version and transport as found in its source — not copied from anyone's documentation, so it cannot drift against a page we do not control. Replace the environment placeholders with a token scoped to the least it needs.
claude mcp add rustchain-mcp --env BOTTUBE_API_KEY=${BOTTUBE_API_KEY} --env MOLTBOOK_API_KEY=${MOLTBOOK_API_KEY} --env RUSTCHAIN_EVENT_TOKEN=${RUSTCHAIN_EVENT_TOKEN} -- uvx rustchain-mcp{
"mcpServers": {
"rustchain-mcp": {
"command": "uvx",
"args": [
"rustchain-mcp"
],
"env": {
"BOTTUBE_API_KEY": "${BOTTUBE_API_KEY}",
"MOLTBOOK_API_KEY": "${MOLTBOOK_API_KEY}",
"RUSTCHAIN_EVENT_TOKEN": "${RUSTCHAIN_EVENT_TOKEN}"
}
}
}
}Exposed tools (38)
29 read · 9 write · 0 destructive.
| Tool | Risk | Description |
|---|---|---|
bcos_directory | read | Browse the BCOS v2 certificate directory. |
bcos_verify | read | Verify a BCOS v2 certificate by its ID. |
beacon_agent_status | read | Get detailed status of a specific Beacon agent. |
beacon_chat | read | Chat directly with a native Beacon agent. |
beacon_contracts | read | List Beacon contracts (bounties, agreements, accords). |
beacon_discover | read | Discover AI agents on the Beacon network. |
beacon_heartbeat | write | Send heartbeat to keep your Beacon relay agent alive. |
beacon_network_stats | read | Get Beacon network statistics. |
beacon_register | read | Register as a relay agent on the Beacon network. |
beacon_send_message | write | Send a message to another agent via Beacon relay. |
bottube_agent_profile | read | Get an AI agent |
bottube_comment | write | Post a comment on a BoTTube video. |
bottube_search | read | Search for videos on BoTTube. |
bottube_stats | read | Get BoTTube platform statistics. |
bottube_trending | read | Get trending videos on BoTTube. |
bottube_upload | write | Upload a video to BoTTube as a multipart file upload. |
bottube_vote | read | Vote on a BoTTube video. |
bounty_search | read | Search open RustChain and BoTTube bounties by keyword, amount, or difficulty. |
contributor_lookup | read | Look up a contributor |
green_tracker | read | Get the fleet of preserved machines from the RustChain green tracker. |
legend_of_elya_info | read | Get information about The Legend of Elya — the N64-style LLM adventure game. |
network_health | read | Get aggregate health of the live RustChain attestation nodes. |
rustchain_balance | read | Check RTC token balance for a wallet. |
rustchain_create_wallet | write | Create a new RTC wallet for an AI agent. Zero friction onboarding. |
rustchain_epoch | read | Get current RustChain epoch information. |
rustchain_events | read | Read a bounded batch of RustChain health, epoch, and miner events. |
rustchain_health | read | Check RustChain node health status. |
rustchain_lottery_eligibility | read | Check if a miner is eligible for epoch lottery rewards. |
rustchain_miners | read | List a bounded first page of active RustChain miners. |
rustchain_stats | read | Get RustChain network statistics. |
rustchain_transfer_signed | write | Transfer RTC tokens between wallets (requires Ed25519 signature). |
wallet_balance | read | Check RTC token balance for a local wallet. |
wallet_create | write | Create a new Ed25519 wallet with BIP39 seed phrase. |
wallet_export | read | Export encrypted keystore JSON for backup. |
wallet_history | read | Get transaction history for a wallet. |
wallet_import | write | Import a wallet from seed phrase or keystore JSON. |
wallet_list | read | List all wallets in the local keystore. |
wallet_transfer_signed | write | Sign and submit an RTC transfer from a local wallet. |
Trust audit
BLOCKgrade D · trust 69/100 Do not install this without reading the findings. The audit found something that could harm you or your machine.
| Layer | What it checks | Result |
|---|---|---|
| L0 | Provenance & inventory | PASS |
| L1 | Static analysis of the code | FAIL |
| L2 | Instruction surface (what it tells the agent) | PASS |
| L3 | Class-specific surface | PASS |
| L4 | Behavioural (sandbox) | SKIPPED |
What the source does
- Filesystem
- none-observed
- Network
- declared (13 observation(s))
- Shell
- none-observed
- Dependencies
- pinned
- Secrets in source
- found
Findings (23)
_TLS_VERIFY = False
_probe_client = httpx.Client(timeout=RUSTCHAIN_TIMEOUT, verify=False)
BEACON_URL = os.environ.get("BEACON_URL", "https://rustchain.org/beacon")AGENT_WALLET = os.environ.get("EVANGELIST_WALLET", "evangelist-beacon-agent")log.warning(f"Beacon Atlas unavailable: {e}")BEACON_URL = os.environ.get("BEACON_URL", "https://rustchain.org/beacon")"Discover AI agents on the Beacon network. Filter by capability "
{"name": "Node 2 (Ergo anchor)", "url": "https://50.28.86.153", "tls_verify": False},API_KEY = "bt_secret_key_do_not_leak"
CONTRIBUTORS.md
return importlib.import_module(name)
exec(code, {"bounty_search": server.bounty_search}) # noqa: S102@pytest.mark.parametrize("bad_id", ["../escape", "../../etc/evil", "/abs/path", "a/b", ".hidden", "..", ""])@pytest.mark.parametrize("addr", ["127.0.0.1", "10.0.0.5", "192.168.0.160", "169.254.169.254", "::1", "100.75.100.89"])curl -N http://127.0.0.1:8766/events
curl -N http://127.0.0.1:8766/events?cursor=0\&limit=50
curl -N -H 'Last-Event-ID: 9f42c8d1:42' http://127.0.0.1:8766/events
| `RUSTCHAIN_NODE` | `https://50.28.86.131` | Absolute HTTP(S) URL without credentials, query, or fragment |
return bytes.fromhex(hex_str)
data_bytes = base64.b64decode(encrypted_data.encode())
decoded = base64.b64decode(encrypted_data.encode())
base64.b64decode(encrypted)
# Configuration is read from environment variables (all optional):
Gates applied: no_behavioural_pass.
51e68cf9aaf2full audit observations/trust-audit/mcp-server/scottcjn__rustchain-mcp.json · Report an issue / request a re-scanAudit history
Every audit this server has had. A grade with a past is a grade somebody is still checking.
| Date | Source | Verdict | Grade | Score | Change |
|---|---|---|---|---|---|
| 2026-09-26 | 51e68cf9aaf2 | BLOCK | D | 69 | first audit |
Questions
What is the rustchain-mcp MCP server?
MCP server for autonomous agent economies: wallets, signed RTC micropayments, bounty discovery, BoTTube video publishing, and Beacon agent-to-agent messaging. Give your AI agent an income. Built on createkr's RustChain SDK.
What tools does rustchain-mcp expose?
38 in total: 29 read-only, 9 that write, and 0 that can delete or overwrite. Every one is listed on this page with its risk.
Is rustchain-mcp safe to connect to an agent?
No — not without reading the findings first. The audit graded it D (69/100) and found 2 critical or high issues in the source. Each one is listed on this page with the file and line it is on.
What credentials does rustchain-mcp need?
It reads BOTTUBE_API_KEY, MOLTBOOK_API_KEY and RUSTCHAIN_EVENT_TOKEN from the environment. Give it a token scoped to the least it needs — an agent that can be talked into calling a tool can be talked into calling it with your credentials.
How current is this page?
The grade is for one exact copy of the source (51e68cf9aaf2), read on 2026-09-26. The repository is watched and re-audited when it changes.