Initia MCP
OfficialThe Initia MCP server provides a comprehensive interface for interacting with the Initia blockchain ecosystem, enabling queries, asset management, and transactions across Initia L1 and L2 rollups (MiniEVM, MiniMove, MiniWasm).
Chain & Account
List supported chains and their capabilities (VM type, features, endpoints)
Get account info, balances, and aggregated portfolio across chains
Validate/convert between bech32 and hex addresses
Get staking delegations, rewards, and unbonding entries
Simulate transactions, estimate gas, and get block headers
Token & Denom
Search tokens by symbol, list registered tokens, get metadata (name, symbol, decimals)
Get balances for native, ERC20, CW20, or Move FA tokens
Format raw amounts and classify denomination types
Transactions
Fetch transactions by hash with VM-aware decoding
Search transactions using CometBFT query syntax
Get recent transactions for an address
Validators, Staking & Governance
List/inspect validators, get staking pool info and annual provisions
Delegate, undelegate, redelegate tokens, and claim staking rewards
List, view, and vote on governance proposals
Bridging & IBC
Find optimal cross-chain routes, execute transfers, and track status
Deposit/withdraw via OPInit bridge (L1↔L2); list bridges, token pairs, and bridgeable chains
List IBC channels, compute IBC denom hashes, and send IBC transfers
Move VM
List modules, get ABIs, query resources and table entries
Call view functions, execute entry functions, publish modules, run scripts
Query DEX liquidity pool pairs, convert denoms/metadata, encode/decode BCS
EVM (MiniEVM chains)
Call contract functions (read-only or state-changing), deploy contracts
Query event logs, receipts, blocks, bytecode, and storage slots
Decode revert reasons and event logs with ABI
CosmWasm (MiniWasm chains)
Query and execute smart contracts; upload, instantiate, migrate, manage admins
Get contract/code metadata, list contracts by code ID, view migration history and raw state
VIP (Lock-Staking & Gauge Voting)
Query VIP stage info, positions, voting power, vesting schedules, and claimable rewards
Lock-delegate, undelegate, redelegate tokens, extend lock durations
Vote on gauge weight distribution, claim VIP and staking rewards
Provide liquidity (pair or stableswap) and lock-delegate LP tokens in one transaction
Username (.init Names)
Resolve .init names to addresses and vice versa
Get username records, NFT metadata, and check availability
Bank
Send tokens to one or more recipients (batch sends supported)
Event Parsing
Parse Cosmos, Move, and CosmWasm events from transactions
Ledger Hardware Wallet
Check device connection status and verify addresses on the device
Provides a comprehensive set of EVM-compatible tools for interacting with Initia L2 rollups (MiniEVM), including contract deployment, function execution, event log querying, and transaction management.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Initia MCP show me my total portfolio balance across all Initia chains"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
@initia/mcp
MCP server and CLI for the Initia blockchain ecosystem. Tools for querying chain state, managing assets, and executing transactions across Initia L1 and L2 rollups (MiniEVM, MiniMove, MiniWasm).
Two interfaces, one codebase:
@initia/mcp— MCP server (stdio transport, for Claude Desktop / LLM agents)initctl— CLI (for humans and scripts)
Quick Start
npm install
npm run buildCLI (initctl)
# Global install
npm install -g .
initctl chain list
# Or run directly without global install
node dist/cli.js chain list
# Or via npx (after npm install)
npx initctl chain listClaude Desktop
Add to claude_desktop_config.json:
{
"mcpServers": {
"initia": {
"command": "npx",
"args": ["-y", "@initia/mcp"],
// optional — see Environment Variables below
"env": {
"INITIA_KEY": "your mnemonic words ...",
"INITIA_NETWORK": "mainnet"
}
}
}
}Claude Code
claude mcp add initia -s user -- npx -y @initia/mcp
# optional — see Environment Variables below
claude mcp add initia -s user \
-e INITIA_KEY="your mnemonic words ..." \
-e INITIA_NETWORK=mainnet \
-- npx -y @initia/mcpCodex
Add to codex.json (or pass via codex --mcp-config codex.json):
{
"mcpServers": {
"initia": {
"command": "npx",
"args": ["-y", "@initia/mcp"],
// optional — see Environment Variables below
"env": {
"INITIA_KEY": "your mnemonic words ...",
"INITIA_NETWORK": "mainnet"
}
}
}
}Gemini CLI
Add to .gemini/settings.json:
{
"mcpServers": {
"initia": {
"command": "npx",
"args": ["-y", "@initia/mcp"],
// optional — see Environment Variables below
"env": {
"INITIA_KEY": "your mnemonic words ...",
"INITIA_NETWORK": "mainnet"
}
}
}
}CLI
# Query
initctl chain list
initctl token search --symbol USDC
initctl move view --module-address 0x1 --module-name coin --function-name balance --args '["0x1"]'
# Transaction (interactive confirm)
initctl bank send --to init1abc... --amount 1000000 --denom uinit
# Transaction (skip confirm)
initctl bank send --to init1abc... --amount 1000000 --denom uinit --yes
# JSON output (for scripts)
initctl token search --symbol INIT --json
# Shell completion
eval "$(initctl completion bash)" # bash
eval "$(initctl completion zsh)" # zsh
initctl completion fish | source # fishEnvironment Variables
Variable | Required | Default | Description |
| No | — | Mnemonic (12/24 words), hex private key ( |
| No |
| HD derivation index (for mnemonic/ledger) |
| No |
| Ledger app: |
| No |
|
|
| No |
| Skip the server-side confirm gate for mutations (MCP only). See Security & Approvals. |
| No |
|
|
| No |
| Use Scan API for enhanced chain data |
Without a signer key, read-only tools still work. Mutation tools return SIGNER_REQUIRED.
Related MCP server: Somnia MCP Server
Security & Approvals
This server can sign and broadcast real transactions. Approvals happen in two independent layers:
MCP client approval (primary). Your MCP client — Claude Code, Codex, Claude Desktop, Gemini CLI — decides whether each tool call runs, normally by prompting you. This is the human gate. The server cannot force it, and a client configured to auto-approve (e.g. "always allow") will not prompt. Treat this as your main safety control.
Server confirm gate (secondary). Every mutation tool takes a
confirmflag (defaultfalse). Without it the tool only simulates and returns the estimated gas and decoded messages; it broadcasts only when called again withconfirm: true. Because the agent suppliesconfirm, this guards against accidental one-shot broadcasts — it is not a substitute for human approval on its own.
AUTO_CONFIRM=true removes layer 2 for mutations. Combined with a client set to auto-approve the tool, this enables fully unattended signing and broadcasting. Use it only on testnet or with low-value keys.
wasm_migrate,wasm_update_admin, andwasm_clear_adminare treated as destructive and always require explicitconfirm: true, even whenAUTO_CONFIRM=true. Every other mutation tool —bank_send,evm_send, bridges, contract deploy/execute (wasm_*,move_*,evm_deploy),governance_vote,staking_manage,ibc_transfer,feegrant_*, and the VIP tools — is not in this exception: withAUTO_CONFIRM=truethey broadcast automatically.All state-changing tools are annotated
destructiveHint: trueso clients that surface this hint can warn before running them. Note this MCP annotation is independent of theAUTO_CONFIRMbypass above: a tool can bedestructiveHint: trueand still auto-broadcast underAUTO_CONFIRM(only the three wasm admin tools are gated server-side).INITIA_NETWORKdefaults tomainnet— setINITIA_NETWORK=testnetfor experimentation.
Key handling. INITIA_KEY is read from the environment and the raw mnemonic/private key is discarded after key derivation at startup. For mainnet or high-value keys prefer a Ledger (INITIA_KEY="ledger"): it adds a hardware confirmation that no software setting — including AUTO_CONFIRM — can bypass. Ledger signing can still time out after 90s even if the transaction was broadcast; check your account or a block explorer before retrying to avoid duplicate spends.
Tools (107)
Chain & Account (10)
Tool | Description |
| List all supported chains (L1 + L2 rollups) |
| Get chain VM type, features, and endpoints |
| Current on-chain gas prices (L1 or L2) |
| Account info and balances |
| Aggregated balances across all chains |
| Validate bech32 or EVM address format |
| Convert between bech32 and hex |
| Staking delegations, rewards, and unbonding |
| Pending staking rewards across validators |
| Simulate a transaction and estimate gas |
Token & Denom (7)
Tool | Description |
| Search tokens by symbol across all chains |
| List registered tokens on a chain |
| Token metadata (name, symbol, decimals) for any type |
| Token balance for native, ERC20, CW20, or Move FA |
| Format raw amount with decimals |
| Classify denomination type (native, ibc, evm, etc.) |
| On-chain bank module metadata |
Transaction (3)
Tool | Description |
| Get transaction by hash with VM-aware decoding |
| Search transactions (CometBFT query syntax) |
| Recent transactions for an address |
Validator & Staking (7)
Tool | Description |
| List validators with status and voting power |
| Detailed validator information |
| Network bonded/unbonded token totals |
| Current annual token provisions (inflation) |
| Delegate, undelegate, redelegate, or claim rewards |
| Vote on a governance proposal |
| List or get governance proposals |
Bridge (14)
Tool | Description |
| Find optimal cross-chain transfer route |
| Execute a cross-chain transfer via router |
| Track cross-chain transfer progress |
| List bridgeable L2 chains |
| List assets available for routing |
| Direct L1↔L2 OPInit deposit/withdraw |
| Query withdrawal status |
| OPInit bridge configuration |
| L1↔L2 token pair mappings |
| Token pair lookup |
IBC (3)
Tool | Description |
| List IBC channels or find channel between two chains |
| Compute IBC denomination hash from path |
| Send tokens via IBC |
Username (4)
Tool | Description |
| Resolve .init names ↔ addresses |
| Full .init username record |
| NFT metadata for .init username |
| Check username availability |
Move VM (14)
Tool | Description |
| List modules deployed at an address |
| Get module ABI (functions, structs) |
| List resources held by an address |
| Query a specific resource |
| Call a view function (read-only) |
| Execute an entry function |
| Deploy module or run script |
| Query a table entry |
| List DEX liquidity pool pairs |
| Denom ↔ metadata conversion |
| BCS serialization utilities |
EVM (10)
Tool | Description |
| Call a contract function (read-only) |
| Send a state-changing transaction |
| Deploy a contract |
| Query event logs |
| Get transaction receipt |
| Get block information |
| Get contract bytecode (Minievm only) |
| Read storage slot (Minievm only) |
| Decode revert reason |
| Decode event logs with ABI |
CosmWasm (12)
Tool | Description |
| Query a smart contract |
| Execute a smart contract function |
| Upload contract bytecode |
| Instantiate a contract |
| Migrate to a new code ID |
| Admin management |
| Contract/code metadata |
| List contracts from a code ID |
| Migration history |
| Raw key-value state |
VIP (16)
Tool | Description |
| Current VIP stage and timing |
| Lock-staking positions |
| Gauge voting power |
| Vesting schedules with reward breakdowns |
| Vote allocations per bridge |
| Claimable VIP rewards |
| Lock-staking management |
| Extend lock duration |
| Gauge voting |
| Reward claiming |
| LP + lock-delegate in one tx |
| Stableswap LP + lock-delegate |
Event Parsing (3)
Tool | Description |
| Parse Cosmos events from a transaction |
| Decode Move module events |
| Decode CosmWasm contract events |
Ledger (2)
Tool | Description |
| Check Ledger device connection |
| Display address on device for verification |
Bank (1)
Tool | Description |
| Send tokens (supports batch sends) |
Architecture
src/
├── index.ts # MCP server entry point (stdio)
├── cli.ts # CLI entry point (initctl)
├── tools/
│ ├── registry.ts # ToolRegistry — shared by MCP and CLI
│ ├── groups.ts # Group definitions (24 groups)
│ ├── index.ts # Side-effect imports for all tool files
│ ├── tx-executor.ts # Mutation flow (dry-run → simulate → broadcast)
│ ├── vm-guard.ts # VM compatibility checks
│ └── *.ts # Tool modules (registry.register() calls)
├── mcp/
│ └── adapter.ts # Registry → McpServer binding
├── cli/
│ ├── adapter.ts # Registry → citty commands + zodToCittyArgs
│ ├── format.ts # TTY / JSON output formatting
│ ├── confirm.ts # Mutation y/N prompt
│ └── completion.ts # Shell completion (bash/zsh/fish)
├── initia/
│ └── chain-manager.ts # Chain context creation, caching
├── config/ # Environment config, chain aliases
├── schemas/ # Shared Zod parameter schemas
├── errors.ts # Typed error codes
├── response.ts # Response serialization
└── logger.ts # Structured JSON loggingTools are registered once in a transport-agnostic ToolRegistry. The MCP and CLI adapters consume the same registry independently — adding a tool to a *.ts file automatically exposes it in both interfaces.
Smart Defaults
Validator by name: Tools accepting a validator address also accept the moniker name (case-insensitive, auto-resolved)
"me" address: Address parameters accept
"me","self","my", or"signer"to resolve to the configured signerVM guard: Contract tools enforce VM compatibility — calling
move_viewon a MiniEVM chain returns aWRONG_VMerror with suggested alternatives
Development
npm run dev # Run MCP server with tsx (hot reload)
npm test # Unit + integration tests
npm run test:smoke # E2E tests against testnet
npm run lint # ESLint + tsc --noEmitLicense
Apache-2.0
Available Tools
113 toolsaccount_getARead-only
Get account info, token balances, and address profile for an address on a specific chain. Balances are paginated (default 10). Describe account/contract types using the terminology appropriate for the chain's VM (see chainType in response).
Inputs: address (required), chain, limit, offset, +2 more.
address_convertARead-only
Convert an address between bech32 (init1...) and hex (0x...) formats.
Inputs: address (required).
address_validateARead-only
Validate whether a string is a valid Initia address (bech32) or EVM address (0x hex). Optionally provide a chain to fetch the on-chain address profile (account type, contract classification, etc.).
Inputs: address (required), chain, network.
amount_formatARead-only
Format a raw token amount with decimals into human-readable form (e.g., "1000000" with 6 decimals -> "1.0").
Inputs: amount (required), decimals (required).
authz_grantsARead-only
Query authorization grants. Provide granter, grantee, or both to filter.
Inputs: chain, granter, grantee, network.
bank_sendB
Send tokens to one or more recipients in a single transaction.
Inputs: sends (required), chain, dryRun, confirm, +2 more.
bridge_depositA
Deposit tokens from L1 to an L2 rollup via OPInit bridge. Requires the bridge ID for the target rollup.
Inputs: bridgeId (required), to (required), amount (required), denom (required), +5 more.
bridge_executeB
Execute a cross-chain transfer. Automatically finds the optimal route and broadcasts the source chain transaction.
Inputs: amount (required), sourceChainId (required), sourceDenom (required), destChainId (required), +6 more.
bridge_list_chainsARead-only
List all L2 chains that support OPInit bridging from/to L1.
Inputs: network.
bridge_routable_assetsARead-only
List all assets available for cross-chain routing via the Router API. Use this to discover valid chain/denom pairs before calling bridge_route or bridge_execute. Optionally filter by a specific chain ID.
Inputs: chainId, network.
bridge_routeBRead-only
Find the optimal cross-chain transfer route between two chains.
Inputs: amount (required), sourceChainId (required), sourceDenom (required), destChainId (required), +2 more.
bridge_transfer_statusARead-only
Track the status of a cross-chain transfer initiated via bridge_execute. Call with the txHash and chainId returned from bridge_execute.
Inputs: txHash (required), chainId (required), network.
bridge_withdrawB
Withdraw tokens from an L2 rollup back to L1 via OPInit bridge.
Inputs: to (required), amount (required), denom (required), chain, +4 more.
bridge_withdrawalsARead-only
List L2->L1 withdrawals for an address on a specific L2 chain.
Inputs: address (required), chain, limit, offset, +2 more.
bridge_withdrawal_statusARead-only
Get the status and details of a specific L2->L1 withdrawal by sequence number.
Inputs: sequence (required), chain, network.
chain_blockARead-only
Get block header and transaction list by height. Omit height to get the latest block.
Inputs: chain, height, network.
chain_block_resultsARead-only
Get block execution results (transaction results, validator updates, consensus param updates) for a given height.
Inputs: height (required), chain, network.
chain_capabilitiesARead-only
Get detailed capabilities for a specific chain: VM type, supported features, and endpoints.
Inputs: chain, network.
chain_gas_pricesARead-only
Get current on-chain gas prices for any chain (L1 or L2). Returns accepted denoms and their gas price amounts.
Inputs: chain, network.
chain_listARead-only
List all supported chains in the Initia ecosystem with their chain IDs and types.
Inputs: network.
delegation_getARead-only
Get staking state for an address: delegations, rewards, and unbonding entries. Returns paginated results (default 10). Use limit/offset to navigate.
Inputs: delegatorAddr (required), chain, limit, offset, +2 more.
denom_classifyARead-only
Classify a token denomination into its type: native, ibc, evm, move, cw20, factory, or l2.
Inputs: denom (required).
denom_metadataARead-only
Get on-chain bank module metadata for a native denomination (name, symbol, decimals). For contract tokens (ERC20/CW20/FA), use token_info instead.
Inputs: denom (required), chain, network.
distribution_rewardsARead-only
Get pending staking rewards for a delegator across all validators.
Inputs: delegatorAddr (required), chain, network.
event_parse_moveBRead-only
Extract and decode Move module events from a transaction. Optionally filter by type tag for auto-parsed JSON data.
Inputs: txHash (required), chain, typeTag, network.
event_parse_txBRead-only
Parse and extract Cosmos events from a transaction. Optionally filter by event type.
Inputs: txHash (required), chain, eventType, network.
event_parse_wasmARead-only
Extract and decode CosmWasm contract events from a transaction. Filters wasm.* event types.
Inputs: txHash (required), chain, network.
evm_callARead-only
Call an EVM contract function (read-only). Provide ABI-encoded calldata. Available on Minievm chains.
Inputs: contractAddress (required), input (required), chain, sender, +1 more.
evm_decode_logsARead-only
Decode EVM event logs using an ABI. Takes raw logs (from evm_get_logs or tx receipt) and returns decoded event names and args.
Inputs: logs (required), abi (required).
evm_decode_revertARead-only
Decode an EVM revert reason from hex data. Optionally provide ABI JSON to decode custom errors.
Inputs: data (required), abi.
evm_deployA
Deploy an EVM contract by submitting creation bytecode. Available on Minievm chains.
Inputs: input (required), chain, value, dryRun, +3 more.
evm_get_blockARead-only
Get EVM block information by number. Available on Minievm chains.
Inputs: chain, blockNumber, includeTransactions, network.
evm_get_codeARead-only
Get the bytecode deployed at an address. Returns empty if the address is an EOA (not a contract). Only available on Minievm rollup chains.
Inputs: address (required), chain, network.
evm_get_logsARead-only
Query EVM event logs with filters. Available on Minievm chains.
Inputs: chain, address, topics, fromBlock, +2 more.
evm_get_storage_atARead-only
Read a raw storage slot of an EVM contract. Only available on Minievm rollup chains.
Inputs: address (required), slot (required), chain, network.
evm_get_tx_receiptARead-only
Get an EVM transaction receipt by hash. Available on Minievm chains.
Inputs: txHash (required), chain, network.
evm_sendA
Send a state-changing EVM transaction. Provide ABI-encoded calldata. Available on Minievm chains.
Inputs: contractAddress (required), input (required), chain, value, +4 more.
feegrant_allowancesARead-only
Query fee grant allowances for an address. Returns all grants where the address is the grantee.
Inputs: grantee (required), chain, network.
feegrant_grantB
Grant fee allowance to another address for gas fee sponsorship. At least one of spendLimit or expiration must be provided.
Inputs: grantee (required), chain, spendLimit, expiration, +4 more.
feegrant_revokeA
Revoke a fee grant allowance previously granted to an address.
Inputs: grantee (required), chain, dryRun, confirm, +2 more.
governance_voteB
Vote on a governance proposal. Options: YES=1, ABSTAIN=2, NO=3, NO_WITH_VETO=4.
Inputs: proposalId (required), option (required), chain, dryRun, +3 more.
ibc_channelsARead-only
List IBC channels for a chain, or find the channel between two specific chains. Useful before ibc_transfer to discover the correct sourceChannel.
Inputs: chain, counterparty, network.
ibc_denom_hashARead-only
Compute the IBC denomination hash from a transfer path. E.g., "transfer/channel-0/uatom" -> "ibc/27394..."
Inputs: path (required).
ibc_transferA
Send tokens via IBC to another chain. Use bridge_route for automatic path discovery.
Inputs: sourceChannel (required), receiver (required), amount (required), denom (required), +6 more.
ledger_statusARead-only
Check signer key type and Ledger device status
Inputs: no named parameters.
ledger_verify_addressARead-only
Display address on Ledger device for physical verification
Inputs: no named parameters.
move_bcs_decodeARead-only
Decode Move BCS bytes back to human-readable values.
Inputs: hexValues (required), types (required).
move_bcs_encodeARead-only
Encode values to Move BCS (Binary Canonical Serialization) format. Useful for preparing complex arguments for move_execute.
Inputs: values (required), types (required).
move_denom_metadataARead-only
Convert a token denom to its Move metadata address. Available on Initia L1 and Minimove chains.
Inputs: denom (required), chain, network.
move_dex_pairsARead-only
List DEX liquidity pool pairs, or look up a specific pair by quote token metadata. Returns LP metadata needed for vip_provide_and_delegate. Available on Initia L1 and Minimove chains.
Inputs: chain, metadataQuote, network.
move_executeB
Execute a Move entry function (state-changing). Available on Initia L1 and Minimove chains.
Inputs: moduleAddress (required), moduleName (required), functionName (required), chain, +6 more.
move_metadata_denomARead-only
Convert a Move metadata address to its token denom. Available on Initia L1 and Minimove chains.
Inputs: metadata (required), chain, network.
move_module_abiARead-only
Get the ABI (functions, structs, type params) of a Move module. Available on Initia L1 and Minimove chains.
Inputs: moduleAddress (required), moduleName (required), chain, network.
move_modulesARead-only
List all Move modules deployed at an address. Use this to discover available modules before calling move_module_abi. Available on Initia L1 and Minimove chains.
Inputs: address (required), chain, network.
move_publishB
Publish (deploy) Move module bytecode to chain. Available on Initia L1 and Minimove chains.
Inputs: codeBytes (required), chain, upgradePolicy, dryRun, +3 more.
move_resource_getARead-only
Query a Move resource at an address. Available on Initia L1 and Minimove chains.
Inputs: address (required), structTag (required), chain, network.
move_resourcesARead-only
List all Move resources held by an address. Use this to discover available resources before calling move_resource_get with a specific struct tag. Available on Initia L1 and Minimove chains.
Inputs: address (required), chain, network.
move_scriptA
Execute a Move script (one-off bytecode, not published). Available on Initia L1 and Minimove chains.
Inputs: codeBytes (required), chain, typeArgs, args, +4 more.
move_table_entryBRead-only
Query a Move table entry by handle and key. Available on Initia L1 and Minimove chains.
Inputs: tableHandle (required), key (required), keyType (required), chain, +1 more.
move_viewBRead-only
Call a Move view function (read-only). Available on Initia L1 and Minimove chains.
Inputs: moduleAddress (required), moduleName (required), functionName (required), chain, +3 more.
opbridge_getARead-only
Get detailed information about a specific OPInit bridge by its ID.
Inputs: bridgeId (required), network.
opbridge_listARead-only
List all OPInit bridges with their config. Returns paginated results (default 10).
Inputs: limit, offset, reverse, network.
opbridge_token_pair_by_l1_denomARead-only
Find the L2 token for a given L1 denomination on a specific bridge.
Inputs: bridgeId (required), l1Denom (required), network.
opbridge_token_pair_by_l2_denomARead-only
Find the L1 token for a given L2 denomination on a specific bridge.
Inputs: bridgeId (required), l2Denom (required), network.
opbridge_token_pairsARead-only
List token pair mappings (L1 <-> L2) for a specific bridge. Returns paginated results (default 10).
Inputs: bridgeId (required), limit, offset, reverse, +1 more.
portfolio_getARead-only
Get aggregated token balances across all chains (L1 + all L2s) for an address.
Inputs: address (required), network.
proposal_getARead-only
Get detailed information about a specific governance proposal.
Inputs: proposalId (required), chain, network.
proposal_listARead-only
List governance proposals on a chain. Returns paginated results (default 10). Use limit/offset to navigate. Filter by status, voter, or depositor.
Inputs: chain, proposalStatus, voter, depositor, +4 more.
simulate_txARead-only
Simulate a transaction to estimate gas and verify execution feasibility. Requires signer to be configured.
Inputs: msgs (required), chain, memo, network.
staking_annual_provisionsARead-only
Get the current annual token provisions (inflation). Useful for estimating staking APR. L1 only.
Inputs: network.
staking_manageB
Manage staking: delegate, undelegate, redelegate, or claim rewards.
Inputs: action (required), validatorAddress (required), chain, amount, +6 more.
staking_poolARead-only
Get the network staking pool summary: total bonded tokens, unbonded tokens, and voting power weights. L1 only.
Inputs: network.
token_balanceARead-only
Get token balance for any token type: native denoms, ERC20, CW20, or Move FA. Automatically resolves contract tokens via the chain VM.
Inputs: address (required), denom (required), chain, network.
token_infoARead-only
Get token metadata (name, symbol, decimals) by resolving the token contract for the chain VM. Works with contract tokens (ERC20, CW20, Move FA) and native denoms.
Inputs: denom (required), chain, network.
token_listARead-only
List all registered tokens on a specific chain. Returns known assets from the registry with denom, symbol, decimals, and metadata.
Inputs: chain, network.
token_searchARead-only
Search tokens by symbol (e.g., "USDC", "INIT") across all chains or on a specific chain. Returns matching assets with denom, decimals, and chain info.
Inputs: symbol (required), chain, network.
tx_by_addressARead-only
Get recent transactions signed by an address. Returns paginated results in reverse chronological order (default 10). Use limit/offset to navigate.
Inputs: address (required), chain, limit, offset, +2 more.
tx_getARead-only
Get transaction info by hash. Default: human-readable decoded output with VM-aware decoding (Move/EVM/Wasm function names, decoded args). Use raw=true only when you need raw proto data.
Inputs: txHash (required), chain, raw, network.
tx_searchARead-only
Search transactions using CometBFT query syntax (e.g., "transfer.sender='init1...'", "tx.height=12345").
Inputs: query (required), chain, page, perPage, +2 more.
username_checkARead-only
Check if a .init username is available for registration.
Inputs: name (required), network.
username_metadataARead-only
Get NFT metadata for a .init username (avatar, description, attributes).
Inputs: name (required), network.
username_recordARead-only
Get the full record for a .init username, including address and expiration.
Inputs: name (required), network.
username_resolveARead-only
Resolve .init names to addresses or addresses to .init names. For hex<->bech32 conversion, use address_convert instead.
Inputs: input (required), network.
validator_getARead-only
Get detailed information about a specific validator.
Inputs: validatorAddr (required), chain, network.
validator_listARead-only
List validators on a chain with their status, voting power, and commission. Returns paginated results (default 10). Use limit/offset to navigate. Filter by status to narrow results.
Inputs: chain, status, limit, offset, +2 more.
vip_claimable_rewardsARead-only
Get claimable VIP rewards for an address from the VIP indexer API.
Inputs: address (required), network.
vip_claim_rewardsA
Claim all pending VIP rewards. Fetches proofs from the VIP indexer and submits claim transactions.
Inputs: dryRun, confirm, memo, network.
vip_claim_staking_rewardsC
Claim staking rewards from VIP lock-staking delegations.
Inputs: dryRun, confirm, memo, network.
vip_delegateA
Lock-delegate tokens to a validator via VIP. Tokens are locked until the specified release time.
Inputs: metadata (required), amount (required), releaseTime (required), validator (required), +4 more.
vip_extend_lockB
Extend the lock duration of a VIP lock-staking position.
Inputs: metadata (required), releaseTime (required), validator (required), newReleaseTime (required), +5 more.
vip_gauge_voteB
Vote on VIP gauge weight distribution by specifying weights for each bridge.
Inputs: cycle (required), votes (required), dryRun, confirm, +2 more.
vip_gauge_vote_by_amountB
Vote on VIP gauge weight distribution by specifying exact amounts for each bridge.
Inputs: cycle (required), votes (required), dryRun, confirm, +2 more.
vip_positionsARead-only
Get all VIP lock-staking positions for an address. Shows locked delegations with metadata, validator, amount, and release time.
Inputs: address (required), network.
vip_provide_and_delegateB
Provide liquidity to a pair pool and lock-delegate the LP tokens to a validator in a single transaction.
Inputs: lpMetadata (required), coinAAmount (required), coinBAmount (required), releaseTime (required), +6 more.
vip_redelegateB
Move a VIP lock-staking position from one validator to another, optionally changing the lock duration.
Inputs: metadata (required), srcReleaseTime (required), srcValidator (required), dstReleaseTime (required), +6 more.
vip_stableswap_provide_and_delegateA
Provide liquidity to a stableswap pool (3+ tokens) and lock-delegate the LP tokens to a validator in a single transaction.
Inputs: lpMetadata (required), amounts (required), releaseTime (required), validator (required), +5 more.
vip_stage_infoARead-only
Get the current VIP stage number, start time, and end time.
Inputs: network.
vip_undelegateB
Undelegate (unlock) tokens from a VIP lock-staking position.
Inputs: metadata (required), releaseTime (required), validator (required), amount, +4 more.
vip_vesting_positionsARead-only
Get VIP vesting positions for an address from the indexer API. Shows bridge rewards with vesting schedules, including initial/claimable/claimed/locked reward breakdowns.
Inputs: address (required), network.
vip_vote_infoARead-only
Get VIP gauge vote info for an address: max voting power, used voting power, and per-bridge weight allocations.
Inputs: address (required), cycle, network.
vip_voting_powerBRead-only
Get VIP gauge voting power for an address.
Inputs: address (required), network.
wasm_clear_adminADestructive
Remove the admin of a CosmWasm contract, making it immutable (no more migrations). Available on Miniwasm chains.
Inputs: contractAddress (required), chain, dryRun, confirm, +2 more.
wasm_code_infoARead-only
Get CosmWasm code info by code ID: creator, checksum, instantiate permission. Available on Miniwasm chains.
Inputs: codeId (required), chain, network.
wasm_contract_historyARead-only
Get migration history (init/migrate entries) for a CosmWasm contract. Available on Miniwasm chains.
Inputs: contractAddress (required), chain, network.
wasm_contract_infoARead-only
Get CosmWasm contract metadata: code_id, admin, label, creator. Available on Miniwasm chains.
Inputs: contractAddress (required), chain, network.
wasm_contracts_by_codeARead-only
List all contract addresses instantiated from a given code ID. Available on Miniwasm chains.
Inputs: codeId (required), chain, network.
wasm_executeA
Execute a CosmWasm smart contract function (state-changing). Available on Miniwasm chains.
Inputs: contractAddress (required), executeMsg (required), chain, funds, +4 more.
wasm_instantiateB
Instantiate a CosmWasm contract from an uploaded code ID. Available on Miniwasm chains.
Inputs: codeId (required), label (required), msg (required), chain, +6 more.
wasm_migrateADestructive
Migrate a CosmWasm contract to a new code ID. Requires admin permission. Available on Miniwasm chains.
Inputs: contractAddress (required), codeId (required), msg (required), chain, +4 more.
wasm_queryARead-only
Query a CosmWasm smart contract (read-only). Available on Miniwasm chains.
Inputs: contractAddress (required), queryMsg (required), chain, network.
wasm_raw_stateBRead-only
Query raw key-value state of a CosmWasm contract. Available on Miniwasm chains.
Inputs: contractAddress (required), key (required), chain, network.
wasm_store_codeB
Upload CosmWasm contract bytecode to chain. The code ID can be found in the transaction events. Available on Miniwasm chains.
Inputs: wasmByteCode (required), chain, dryRun, confirm, +2 more.
wasm_update_adminADestructive
Change the admin of a CosmWasm contract. Only current admin can call. Available on Miniwasm chains.
Inputs: contractAddress (required), newAdmin (required), chain, dryRun, +3 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 113 tools
The domain-prefixed names (vip_, wasm_, move_, evm_, bridge_) do a lot of disambiguation, and descriptions are generally precise. However, the sheer number of tools creates many close pairs—vip_claimable_rewards vs vip_claim_rewards, wasm_contract_info vs wasm_code_info, token_balance vs account_get vs portfolio_get—that make selecting the right one harder than it should be.
Names mostly follow a snake_case domain_operation convention, with clear families like vip_delegate/vip_undelegate/vip_redelegate. Consistency breaks down, though: some resources use get (evm_get_code), some use bare nouns (vip_positions, move_modules), and the inverse pair move_denom_metadata/move_metadata_denom is easy to misread.
113 tools is an extreme count by any standard and far beyond the 25+ threshold where workflows become heavy. A tool set this large defeats quick discovery even when individual descriptions are good, and many read operations could be consolidated behind a smaller set of parameterized tools.
The server covers an unusually broad surface: accounts, tokens, staking, governance, IBC/OPInit bridges, and execution/query for Move, EVM, and CosmWasm. Minor gaps exist (no proposal submission, authz is query-only, no fee-grant update), but most core user workflows have no dead ends.
Maintenance
Related MCP Connectors
Manage your blockchain infrastructure across 80+ chains with your agents.
ERC-8004 agent identity, on-chain subscriptions, reputation, A2A tasks and chat over 53 tools.
Provide AI agents and automation tools with contextual access to blockchain data including balance…
Read-only on-chain intelligence for AI agents on Base: balances, tokens, gas, tx status.
Related MCP Servers
- AlicenseCqualityDmaintenanceEnables AI agents to interact with cryptocurrency ecosystems through wallet management, trading operations (swaps, DCA, limit orders), staking, and multi-chain support starting with Solana.37GPL 3.0
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to interact with the Somnia blockchain network, including documentation search, blockchain queries, wallet management, cryptographic signing, and on-chain operations.MIT
- FlicenseCqualityCmaintenanceEnables AI agents to interact with any EVM-compatible blockchain through natural language, supporting token swaps, cross-chain bridges, staking, lending, governance, gas optimization, and portfolio tracking across networks like Ethereum, BSC, Polygon, Arbitrum, and more.10049 npm44-
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to interact with the AI Network blockchain by managing accounts, submitting transactions, and reading database values. It supports registering Hyper Agents and accessing a Layer 2 DAG-based shared agent memory system based on staking status.6MIT