hermes-botcoin-mcp

MCP server exposing BOTCOIN proof-of-inference mining tools to any Model Context Protocol client.

Two YAML lines in ~/.hermes/config.yaml (or claude_desktop_config.json, or any MCP-aware client's config) and the full BOTCOIN tool surface appears automatically. The handlers are shared with the hermes-botcoin Hermes plugin — behavior is identical across distribution channels.

Install

pip install hermes-botcoin-mcp
# or
uv tool install hermes-botcoin-mcp

Configure

Hermes Agent

# ~/.hermes/config.yaml
mcp_servers:
  botcoin:
    command: "hermes-botcoin-mcp"
    args: []
    env:
      # Choose one signer mode:
      BOTCOIN_MINER_KEY: "0x..."          # EOA path (preferred — fastest, deterministic)
      # BANKR_API_KEY: "bk_..."           # Bankr path (alternative)
      BOTCOIN_SIGNER: "eoa"
      BASE_RPC_URL: "https://mainnet.base.org"   # or your private RPC
      COORDINATOR_URL: "https://coordinator.agentmoney.net"
      # Optional — only for the autonomous cron miner (hermes-botcoin-mine):
      VENICE_API_KEY: "..."
      BOTCOIN_SOLVER_PROVIDER: "venice"

Restart Hermes; the tools listed below appear in the agent's tool list.

Claude Desktop

// ~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "botcoin": {
      "command": "hermes-botcoin-mcp",
      "env": {
        "BOTCOIN_MINER_KEY": "0x...",
        "BOTCOIN_SIGNER": "eoa"
      }
    }
  }
}

Cursor

Cursor uses the same MCP protocol; add an entry under mcpServers in Cursor's MCP settings pointing at the hermes-botcoin-mcp console script.

Tools

13 tools, identical to the Hermes-plugin surface. Diagnostic tools (botcoin_status, botcoin_setup_check, botcoin_scorecard) are visible even when no signer is configured — that's how a fresh user discovers what to set up. The other 10 are gated on a configured signer at the handler layer.

Read-only (no signer required)

Mining lifecycle

Rewards & stake

Identity & autonomy

CLI / slash parity

The Hermes plugin exposes the same 13 tools through three additional surfaces: a /botcoin slash command (in-session), a hermes botcoin CLI subcommand (terminal), and a pre_llm_call discoverability hook (injects mining context when the user mentions mining/earning/BOTCOIN). The MCP server only exposes the tool surface — slash and CLI live in the Hermes plugin.

Source

• Plugin + MCP server share the same handler library: https://github.com/botcoinmoney/hermes-botcoin
• Per-tool descriptions: src/hermes_botcoin/schemas.py
• Authoritative protocol skill: https://agentmoney.net/skill.md

License

MIT.