Bostrom MCP

Install

Config snippet generator goes here (5 client tabs)

README

# bostrom-mcp

[MCP](https://modelcontextprotocol.io) server for the [Bostrom](https://cyb.ai) 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

```bash
cd rust
cargo build --release
```

Binary: `rust/target/release/bostrom-mcp`

### Option 2: Claude Code (CLI)

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

With write tools:

```bash
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:

```jsonc
{
  "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:

```jsonc
{
  "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](https://modelcontextprotocol.io). 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](https://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

| Variable | Default | Description |
|----------|---------|-------------|
| `BOSTROM_MNEMONIC` | — | Wallet mnemonic for write tools. Without it, only read tools are available. |
| `BOSTROM_RPC` | `https://rpc.bostrom.cybernode.ai` | RPC endpoint |
| `BOSTROM_LCD` | `https://lcd.bostrom.cybernode.ai` | LCD/REST endpoint |
| `BOSTROM_IPFS_API` | `https://io.cybernode.ai` | IPFS API for pinning content |
| `BOSTROM_GAS_PRICE` | `0.01boot` | Gas price |
| `BOSTROM_GAS_MULTIPLIER` | `1.4` | Gas estimate multiplier |
| `BOSTROM_MIN_GAS` | `100000` | Minimum gas limit |
| `BOSTROM_MAX_SEND_AMOUNT` | — | Circuit breaker: max amount per send (optional) |

## Tools

### Infrastructure (3)

| Tool | Description |
|------|-------------|
| `infra_chain_status` | Latest block height, time, chain ID, sync status |
| `infra_tx_search` | Search transactions by sender, contract, or message type |
| `infra_tx_detail` | Full decoded transaction by hash |

### Knowledge Graph — Read (6)

| Tool | Description |
|------|-------------|
| `graph_search` | Search cyberlinks by particle CID or neuron address |
| `graph_rank` | Get cyberank score for a particle |
| `graph_neuron` | Get neuron profile and cyberlink count |
| `graph_particle` | Fetch particle content by CID from IPFS |
| `graph_recent_links` | Get the most recent cyberlinks |
| `graph_stats` | Total cyberlinks and active neurons |

### Knowledge Graph — Write (5)

| Tool | Description |
|------|-------------|
| `graph_create_cyberlink` | Create a single cyberlink between two CIDs |
| `graph_create_cyberlinks` | Create multiple cyberlinks in one transaction |
| `graph_investmint` | Convert HYDROGEN into millivolt or milliampere |
| `graph_pin_content` | Pin text content to IPFS and return the CID |
| `graph_create_knowledge` | Compound: pin content to IPFS then create cyberlinks |

### Economy (6)

| Tool | Description |
|------|-------------|
| `economy_balances` | All token balances for an address |
| `economy_supply` | Total supply for a token denom |
| `economy_mint_price` | Current Volt and Ampere mint prices |
| `economy_staking` | Delegations, rewards, and unbonding for an address |
| `economy_pools` | Liquidity pool stats |
| `economy_inflation` | Current inflation rate and minting parameters |

### Wallet (7)

| Tool | Description |
|------|-------------|
| `wallet_info` | Get wallet address and all balances |
| `wallet_send` | Send tokens to an address |
| `wallet_delegate` | Delegate tokens to a validator |
| `wallet_undelegate` | Undelegate tokens from a validator |
| `wallet_redelegate` | Move delegation between validators |
| `wallet_claim_rewards` | Claim staking rewards from a validator |
| `wallet_vote` | Vote on a governance proposal |

### Governance (4)

| Tool | Description |
|------|-------------|
| `gov_proposals` | List proposals (active, passed, rejected, all) |
| `gov_proposal_detail` | Full proposal details with vote tally |
| `gov_validators` | Active validator set with commission and voting power