bostrom-mcp

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

89 tools: 45 read + 44 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

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

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

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)

Lithium Mining — Read (26)

Tool	Description
li_block_context	Current block hash and data hash for lithium v1 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, seed, difficulty, stats, epoch, proofs, emission
li_mine_config	Difficulty, base reward, period duration, target proofs
li_seed	Current mining seed and interval
li_difficulty	Current difficulty, min profitable, window proof count
li_epoch_status	Current epoch: start/end blocks, proof count, target solutions
li_proof_stats	Epoch proof counters and total work
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 height
li_miner_epoch_stats	Miner's proof count for a specific epoch
li_verify_proof	Dry-run verify a proof without submitting
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 (6)

Tool	Description
li_submit_proof	Submit a v4 seed-based mining proof
li_submit_lithium_proof	Submit a lithium v1 proof with block context
li_stake	Stake LI tokens
li_unstake	Unstake LI tokens
li_claim_rewards	Claim LI staking rewards
li_set_referrer	Set referrer for your address

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 routes from an address

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

IBC (2)

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

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

Agent workflows

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

• Lithium mining (v4): li_mine_state → compute proof → li_verify_proof → li_submit_proof → li_stake
• Lithium mining (v1): li_block_context + li_epoch_status → compute proof → li_submit_lithium_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