bostrom-mcp

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

87 tools: 44 read + 43 write. Read tools work with zero configuration. Write tools require a wallet mnemonic.

Installation

Option 1: Claude Desktop

Open Settings > Developer > Edit Config and add:

{
  "mcpServers": {
    "bostrom": {
      "command": "npx",
      "args": ["-y", "bostrom-mcp"]
    }
  }
}

Restart Claude Desktop. You should see the Bostrom tools in the tool list.

To enable write tools (send tokens, create cyberlinks, etc.), add your wallet mnemonic:

{
  "mcpServers": {
    "bostrom": {
      "command": "npx",
      "args": ["-y", "bostrom-mcp"],
      "env": {
        "BOSTROM_MNEMONIC": "your twelve word mnemonic phrase here ..."
      }
    }
  }
}

Option 2: Claude Code (CLI)

claude mcp add bostrom -- npx -y bostrom-mcp

With write tools:

claude mcp add bostrom -e BOSTROM_MNEMONIC="your twelve word mnemonic phrase here ..." -- npx -y bostrom-mcp

Option 3: Cursor

Open Settings > MCP Servers > Add Server and configure:

• Name: bostrom
• Type: command
• Command: npx -y bostrom-mcp

Or add to .cursor/mcp.json in your project:

{
  "mcpServers": {
    "bostrom": {
      "command": "npx",
      "args": ["-y", "bostrom-mcp"],
      "env": {
        "BOSTROM_MNEMONIC": "your twelve word mnemonic phrase here ..."
      }
    }
  }
}

Option 4: Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "bostrom": {
      "command": "npx",
      "args": ["-y", "bostrom-mcp"],
      "env": {
        "BOSTROM_MNEMONIC": "your twelve word mnemonic phrase here ..."
      }
    }
  }
}

Option 5: Any MCP client

Run the server directly:

npx -y bostrom-mcp

The server 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 44 read tools work normally — you can explore the knowledge graph, check balances, view proposals, and more.

Environment variables

Tools

Knowledge Graph — Read (6)

Knowledge Graph — Write (5)

Economy (6)

Wallet (7)

Token Factory (6)

Liquidity & Swap (7)

CosmWasm Contracts (7)

Lithium Mining — Read (25)

Lithium Mining — Write (5)

Energy Grid (4)

Governance (4)

IBC (2)

Infrastructure (3)

Agent workflows

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

• Lithium mining: li_mine_state → compute proof → li_verify_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

Development

npm install
npm run build
node dist/index.js

License

MIT