approve_token_spending
Approve another address (like a DeFi protocol or exchange) to spend your ERC20 tokens. This is often required before interacting with DeFi protocols.
LABSCO SUMMARY
One mnemonic in the environment signs everything on this surface, including deploy_evm_contract and dex-swap — there is no read-only mode to fall back on.
The read tools default to your own address when none is passed, which is convenient and also a standing reminder that the server always knows whose keys it holds. The DEX path is the one place the descriptions enforce an order: dex-find-routes, dex-simulate-swap and dex-swap each state that pools must be checked with dex-get-pools first, and the simulate step exists so the expected outcome is known before slippage is committed. query-network is the intentional escape hatch, and it is honest about the cost of that — it will execute any gRPC-gateway path, and tells you to read the openapi specification at openapi://{networkName} before calling it, which means the tool list is a floor on what this can reach rather than a ceiling.
What it is
A MANTRA chain client covering the Cosmos side — bank, staking, IBC, CosmWasm and generic gRPC-gateway queries — and the EVM side — contract read, write and deploy, plus ERC20, ERC721 and ERC1155 transfers — from a single mnemonic.
What you get
- Balances across the token standards: get-balance and get_evm_balance read native holdings, get_token_balance reads an ERC20, get_nft_balance returns the count of ERC721 tokens an address holds from a collection, and get_erc1155_balance returns the quantity held of one ERC1155 token ID.
- Staking from discovery to payout: get-validators lists validators, delegate and undelegate move stake against an operatorAddress with a denom and memo, get-delegations reads current positions, and get-available-rewards then claim-rewards read and collect what is owed.
- Swaps with a rehearsal step built in: dex-get-pools lists the liquidity pools, dex-find-routes finds routes between an input and output denom, dex-simulate-swap returns the expected outcome without executing, and dex-swap executes under a slippage bound.
- Contract work on the CosmWasm side and the EVM side: cosmwasm-contract-query runs a read-only function and cosmwasm-contract-execute changes state with attached funds; read_evm_contract, write_evm_contract and deploy_evm_contract take an abi and args with maxFeePerGas and maxPriorityFeePerGas ceilings; is_contract distinguishes a contract from an externally owned account.
- Transfers on the EVM side: transfer_om moves native OM, transfer_erc20 and transfer_token move ERC20 balances, transfer_nft moves an ERC721 token, transfer_erc1155 moves a quantity of a multi-token ID, and approve_token_spending authorises a spenderAddress such as a DeFi protocol.
- Chain reads and a deliberate escape hatch: get-account-info returns account state, get-block-info reads from CometBFT RPC and get-block-info-evm from EVM RPC, get_transaction and get_transaction_receipt resolve a txHash, estimate_gas prices a transaction before you commit to it, and query-network executes any gRPC-gateway path the dedicated tools do not cover.
- Cross-chain movement: ibc-transfer sends tokens over IBC with sourcePort, sourceChannel, an ibcMemo and a timeoutHeight or timeoutTimestamp.
- Token and collection metadata: get_erc20_token_info returns name, symbol, decimals and total supply, get_nft_info returns collection name, symbol, token URI and current owner, get_erc1155_token_uri returns the metadata URI, and check_nft_ownership confirms whether an address holds a given token ID.
- sign-and-broadcast signs and broadcasts a generic cosmos-sdk transaction from the messages you supply, and get_address_from_mnemonic derives the EVM address the server will sign as.
Requirements
A mnemonic phrase for the account that will sign, supplied as MNEMONIC — get_address_from_mnemonic derives the EVM address from it. CUSTOM_NETWORKS is also read from the environment, and every tool takes a networkName.
Setup effort
One command — npx -y mantrachain-mcp@latest
USE CASES
01
Moving tokens without leaving the chat
Check what an address holds, work out what the transfer will cost, and send it — including several coins in one transaction. The same mnemonic signs on both sides of the chain, so an EVM transfer is the same conversation as a Cosmos one.
02
Staking, and collecting what it earned
Read the validator set, delegate to one, then come back later to see what has accrued and claim it. Unstaking runs through the same path.
03
Swapping with a dry run first
Confirm both tokens are actually in a pool, find the routes between them, simulate the swap to see what comes out the other side, and only then execute it. The tool descriptions insist on the pool check first, so the order is not optional.
04
Working a contract on either side of the chain
Read from a CosmWasm or EVM contract without spending gas, then call the state-changing function when you are ready. Deploying a new EVM contract returns both the transaction hash and the deployed address.
42 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
bank-send
Send tokens to another address. Supports sending multiple coins in one transaction.
check_nft_ownership
Check if an address owns a specific NFT
claim-rewards
Claim rewards for a specific validator
cosmwasm-contract-execute
Execute a function on a cosmwasm contract that changes state
cosmwasm-contract-query
Query a smart cosmwasm contract by executing a read-only function
delegate
Delegate/Stake tokens to a validator
deploy_evm_contract
Deploy a new evm contract to the blockchain. This creates a new contract instance and returns both the deployment transaction hash and the deployed contract address.
dex-find-routes
Find available swap routes between two tokens - must first check two tokens are available in the DEX pools by using dex-get-pools
dex-get-pools
Get all available liquidity pools from the DEX
dex-simulate-swap
Simulate a token swap to get expected outcome without executing it - must first check two tokens are available in the DEX pools by using dex-get-pools
dex-swap
Execute a token swap on the DEX - must first check two tokens are available in the DEX pools by using dex-get-pools
estimate_gas
Estimate the gas cost for a transaction
get_address_from_mnemonic
Get the EVM address derived from a mnemonic phrase
get_erc1155_balance
Get the balance of a specific ERC1155 token ID owned by an address. ERC1155 allows multiple tokens of the same ID, so the balance can be greater than 1.
get_erc1155_token_uri
Get the metadata URI for an ERC1155 token (multi-token standard used for both fungible and non-fungible tokens). The URI typically points to JSON metadata about the token.
get_erc20_token_info
Get comprehensive information about an ERC20 token including name, symbol, decimals, total supply, and other metadata. Use this to analyze any token on EVM chains.
get_evm_balance
Get the native token balance (OM) for an address (defaults to your own address if none provided)
get_nft_balance
Get the total number of ERC721 NFTs owned by an address from a specific collection. This returns the count of NFTs, not individual token IDs.
get_nft_info
Get detailed information about a specific NFT (ERC721 token), including collection name, symbol, token URI, and current owner if available.
get_token_balance
Get the balance of an ERC20 token for an address
get_transaction
Get detailed information about a specific evm transaction by its hash. Includes sender, recipient, value, data, and more.
get_transaction_receipt
Get a evm transaction receipt by its hash
get-account-info
Get current account information
get-available-rewards
Get all available rewards for an address
get-balance
Get balance of an address (defaults to your own address if none provided)
get-block-info
Get block information from cometbft rpc
get-block-info-evm
Get a block information from EVM rpc
get-delegations
Get current staking information for an address
get-validators
Get all validators
ibc-transfer
Send tokens via IBC transfer.
is_contract
Check if an address is a smart contract or an externally owned account (EOA)
query-network
Execute a generic network gRPC Gateway query against chain APIs when you cannot find the required information from other tools. You MUST first check the available query/service by reading the openapi specification from the resource openapi://{networkName} to understand available query/service, methods, required parameters and body structure.
read_evm_contract
Read data from a evm contract by calling a view/pure function. This doesn't modify blockchain state and doesn't require gas or signing.
sign-and-broadcast
Sign and broadcast a generic cosmos-sdk transaction
transfer_erc1155
Transfer ERC1155 tokens to another address. ERC1155 is a multi-token standard that can represent both fungible and non-fungible tokens in a single contract.
transfer_erc20
Transfer ERC20 tokens to another address
transfer_nft
Transfer an NFT (ERC721 token) from one address to another. Requires the private key of the current owner for signing the transaction.
transfer_om
Transfer native tokens (OM) to an address via EVM
transfer_token
Transfer ERC20 tokens to an address
undelegate
Undelegate/Unstake tokens from a validator
write_evm_contract
Write data to a evm contract by calling a state-changing function. This modifies blockchain state and requires gas payment and transaction signing.
BEFORE YOU INSTALL
What to know first
Tools you get
42 tools when we connected.
Requires
- npx on PATH
- MNEMONIC in your environment
- CUSTOM_NETWORKS in your environment
CONTEXT COST
Moderate Standing cost
Rated by the size of the 42 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Add the block to your client, or run the command directly.
Server setup
Configuration file
JSON
{
"mcpServers": {
"mantrachain-mcp": {
"command": "npx",
"args": [
"-y",
"mantrachain-mcp@latest"
],
"env": {
"MNEMONIC": "<YOUR_MNEMONIC>",
"CUSTOM_NETWORKS": "{\"my-custom-net\":{\"rpcEndpoint\":\"https://rpc.custom-network.io\",\"apiEndpoint\":\"https://api.custom-network.io\",\"chainId\":\"my-custom-net-1\",\"prefix\":\"custom\",\"denom\":\"ucustom\",\"gasPrice\":\"0.01\",\"isMainnet\":false}}"
}
}
}
}npx
TERMINAL
npx -y mantrachain-mcp@latest
