MantraChain

You can run the MantraChain MCP Server to interact with MantraChain (Cosmos SDK) using a flexible set of tools. It lets you send tokens, stake with validators, query balances, sign transactions, and explore blockchain data through a consistent MCP interface. You can operate locally via standard input/output or expose a streamable HTTP/SSE endpoint for remote clients.

How to use

You use an MCP client to connect to the MantraChain MCP Server and perform actions such as sending tokens, delegating stake, querying balances, and executing smart contract or DEX related operations. You can choose between two transport modes: stdio for local use or HTTP with SSE for remote access. In stdio mode, your client talks directly to the command, while in HTTP mode the server exposes an endpoint on port 3000 and communicates with clients via Server-Sent Events.

How to install

Prerequisites: you need Node.js and npm installed on your system. Ensure you have a mnemonic seed and a target network configuration if you plan to connect to a custom network.

Install and run in stdio mode using the package directly or via npx.

# Using installed package
mantrachain-mcp

# Using npx
npx -y mantrachain-mcp@latest

Additional configuration and run notes

To enable the streamable HTTP mode, run with the --http flag. This starts an HTTP server on port 3000 and serves the MCP interface over Server-Sent Events.

# Using installed package
mantrachain-mcp --http

# Using npx
export MNEMONIC="YOUR_MNEMONIC"
export CUSTOM_NETWORKS="YOUR_CUSTOM_NETWORKS_JSON"
npx -y mantrachain-mcp@latest -- --http

Security and environment setup

Set your wallet mnemonic and any network customizations via environment variables before starting the server. The MNEMONIC variable is mandatory for wallet access, and CUSTOM_NETWORKS allows you to extend or override network configurations.

Available tools

bank-send

Send tokens to another address, supporting multiple coins per transaction.

get-balance

Query the balance of an address; defaults to your own address if none is provided.

get_evm_balance

Get the native token balance for an EVM address.

get_token_balance

Check ERC20 token balance for a given address.

get_nft_balance

Retrieve ERC721 NFT counts for an address from a collection.

get_erc1155_balance

Query ERC1155 token balance for a specific token ID.

get_address_from_mnemonic

Derive an EVM address from your mnemonic.

delegate

Delegate tokens to a validator (stake).

undelegate

Undelegate tokens from a validator.

claim-rewards

Claim staking rewards for a validator.

get-validators

List all validators.

get-delegations

Get current staking information for an address.

get-available-rewards

List all available staking rewards for an address.

get-account-info

Fetch current account information.

get-block-info

Query Cosmos block info via the cometbft RPC.

get-block-info-evm

Query block info via the EVM RPC.

query-network

Execute a generic network query against chain APIs.

ibc-transfer

Send tokens via IBC transfer.

cosmwasm-contract-query

Query a CosmWasm smart contract (read-only).

cosmwasm-contract-execute

Execute a function on a CosmWasm contract (state-changing).

read_evm_contract

Read data from an EVM contract (view/pure).

write_evm_contract

Write data to an EVM contract (state-changing).

deploy_evm_contract

Deploy a new EVM contract.

is_contract

Check if an address is a contract or an EOA.

dex-get-pools

List all available liquidity pools on the DEX.

dex-find-routes

Find swap routes between two tokens.

dex-simulate-swap

Simulate a token swap to estimate outcome without executing it.

dex-swap

Execute a token swap on the DEX with slippage protection.

sign-and-broadcast

Sign and broadcast a generic Cosmos transaction.

get_transaction

Fetch detailed information about an EVM transaction by hash.

get_transaction_receipt

Get EVM transaction receipt by hash.

estimate_gas

Estimate gas cost for a transaction.

transfer_om

Transfer native OM tokens via EVM.

transfer_erc20

Transfer ERC20 tokens to another address.

approve_token_spending

Approve another address to spend your ERC20 tokens.

transfer_nft

Transfer an ERC721 NFT to another address.

transfer_erc1155

Transfer ERC1155 tokens to another address.

transfer_token

Transfer ERC20 tokens to an address.