bostrom-mcp

MCP server for the Bostrom blockchain — knowledge graph, economy, lithium mining, governance, infrastructure, and autonomous agent capabilities.

85 tools: 45 read + 40 write. Read tools work with zero configuration. Write tools require a wallet mnemonic. Built-in CPU miner for Lithium proof-of-work.

Installation

Option 1: Build from source

cd rust
cargo build --release

Binary: rust/target/release/bostrom-mcp

Option 2: Claude Code (CLI)

claude mcp add bostrom -- /path/to/bostrom-mcp

With write tools:

claude mcp add bostrom \
  -e BOSTROM_MNEMONIC="your twelve word mnemonic phrase here ..." \
  -- /path/to/bostrom-mcp

Option 3: Claude Desktop

Open Settings > Developer > Edit Config and add:

{
  "mcpServers": {
    "bostrom": {
      "command": "/path/to/bostrom-mcp",
      "env": {
        "BOSTROM_MNEMONIC": "your twelve word mnemonic phrase here ..."
      }
    }
  }
}

Option 4: Cursor

Add to .cursor/mcp.json in your project:

{
  "mcpServers": {
    "bostrom": {
      "command": "/path/to/bostrom-mcp",
      "env": {
        "BOSTROM_MNEMONIC": "your twelve word mnemonic phrase here ..."
      }
    }
  }
}

Option 5: Any MCP client

The binary communicates over stdio using the Model Context Protocol. Any MCP-compatible client can connect to it.

Getting a wallet

Write tools require a Bostrom wallet mnemonic. If you don't have one:

1. Install cyb.ai or any Cosmos wallet (Keplr, Cosmostation)
2. Create a new wallet and save the mnemonic phrase
3. Fund it with BOOT tokens (needed for gas fees)
4. Set BOSTROM_MNEMONIC in your MCP client config

Without a mnemonic, all 45 read tools work normally — you can explore the knowledge graph, check balances, view proposals, mine proofs, and more.

Environment variables

Tools

Infrastructure (3)

Knowledge Graph — Read (6)

Knowledge Graph — Write (5)

Economy (6)

Wallet (7)

Governance (4)

Lithium Mining — Read (21)

Lithium Mining — Write (5)

Lithium Mining — CPU Miner (1)

Token Factory (6)

Liquidity & Swap (7)

CosmWasm Contracts (7)

Energy Grid (4)

IBC (2)

Agent workflows

With write tools enabled, an LLM agent can perform autonomous workflows:

• Lithium mining: li_mine_proof(auto_submit: true) — single-tool mining with auto-submission (difficulty auto-set from contract)
• Manual mining: li_mine_state → li_mine_proof → li_submit_proof → li_stake
• Token launch + market: token_create → token_set_metadata → token_mint → liquidity_create_pool → graph_create_knowledge
• Knowledge graph: graph_pin_content → graph_create_cyberlink → graph_search → graph_rank
• Governance: gov_proposals → gov_proposal_detail → wallet_vote
• DeFi: swap_estimate → swap_tokens → liquidity_deposit
• Contract deployment: wasm_upload → wasm_instantiate → contract_execute

Dependencies

• uhash-prover — UniversalHash CPU solver (feature-gated behind mining)
• lithium-cli — Contract types and mainnet deployment addresses (lib-only, no heavy CLI deps)

Development

cd rust
cargo build --release
# Without mining (smaller binary):
cargo build --release --no-default-features

License

MIT