bostrom-mcp.md

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:

Install cyb.ai or any Cosmos wallet (Keplr, Cosmostation)
Create a new wallet and save the mnemonic phrase
Fund it with BOOT tokens (needed for gas fees)
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
`gov_params`	Chain parameters

Lithium Mining — Read (21)

Tool	Description
`li_block_context`	Current block hash and data hash for mining
`li_core_config`	Token denom, admin, paused status
`li_burn_stats`	Total LI burned
`li_total_minted`	Total LI minted and supply cap
`li_mine_state`	Full mine state: config, window status, stats, emission
`li_mine_config`	Max proof age, gas cost, window size, PID interval, min profitable difficulty
`li_window_status`	Sliding window: proof count, d_rate, base rate, min profitable difficulty, alpha, beta
`li_emission`	Emission breakdown: mining, staking, referral
`li_reward_estimate`	Estimate LI reward for a given difficulty
`li_mine_stats`	Aggregate: total proofs, rewards, unique miners
`li_miner_stats`	Per-miner: proofs submitted, total rewards, last proof time
`li_recent_proofs`	Recent proof submission transactions
`li_stake_config`	Unbonding period, linked contracts
`li_total_staked`	Total LI staked across all stakers
`li_stake_info`	Staking state for an address
`li_staking_stats`	Reserve, total staked, reward index
`li_refer_config`	Referral contract config
`li_referrer_of`	Who referred a specific miner
`li_referral_info`	Referral rewards and count for a referrer
`li_community_pool`	Unclaimed community pool balance
`li_miner_tx_history`	Miner's recent contract TX history

Lithium Mining — Write (5)

Tool	Description
`li_submit_proof`	Submit a mining proof with client-chosen difficulty
`li_stake`	Stake LI tokens
`li_unstake`	Unstake LI tokens
`li_claim_rewards`	Claim LI staking rewards
`li_claim_unbonding`	Claim matured unbonding LI tokens
`li_claim_referral_rewards`	Claim accumulated referral rewards

Lithium Mining — CPU Miner (1)

Tool	Description
`li_mine_proof`	Mine a proof using CPU (UniversalHash PoW), optionally auto-submit on-chain. Generates random 32-byte challenge locally, uses `lithium-cli` contract types for correct `submit_proof` message format.

Token Factory (6)

Tool	Description
`token_create`	Create a new token denom (costs ~10,000 BOOT)
`token_set_metadata`	Set token name, symbol, description, exponent
`token_mint`	Mint tokens to an address
`token_burn`	Burn tokens from an address
`token_change_admin`	Transfer token admin to another address
`token_list_created`	List all denoms created by this wallet

Liquidity & Swap (7)

Tool	Description
`swap_tokens`	Swap tokens with auto pool discovery and price calculation
`swap_estimate`	Preview a swap: find pool, get price, estimate output
`liquidity_create_pool`	Create a Gravity DEX pool (costs ~1,000 BOOT)
`liquidity_deposit`	Deposit tokens into a pool
`liquidity_withdraw`	Withdraw LP tokens from a pool
`liquidity_swap`	Swap via pool with explicit pool ID and limit price
`liquidity_pool_detail`	Get pool reserves, parameters, and batch info

CosmWasm Contracts (7)

Tool	Description
`contract_execute`	Execute a contract message
`contract_execute_multi`	Execute multiple contract messages atomically
`wasm_upload`	Upload .wasm bytecode to chain
`wasm_instantiate`	Instantiate a contract from code ID
`wasm_migrate`	Migrate a contract to new code
`wasm_update_admin`	Update contract admin
`wasm_clear_admin`	Clear contract admin (irreversible)

Energy Grid (4)

Tool	Description
`grid_create_route`	Create an energy route to another address
`grid_edit_route`	Edit route allocated value (millivolt/milliampere)
`grid_delete_route`	Delete an energy route
`grid_list_routes`	List all energy routes from an address

IBC (2)

Tool	Description
`ibc_transfer`	IBC token transfer to another chain
`ibc_channels`	List IBC channels and their status

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

Folder

Synonyms

github/subgraphs/bostrom-mcp

bostrom-mcp

bostrom-mcp.md

bostrom-mcp

Installation

Option 1: Build from source

Option 2: Claude Code (CLI)

Option 3: Claude Desktop

Option 4: Cursor

Option 5: Any MCP client

Getting a wallet

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

Dependencies

Development

License

Folder

Synonyms

Neighbours