Skip to main content
Glama

@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 build

CLI (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 list

Claude 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/mcp

Codex

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    # fish

Environment Variables

Variable

Required

Default

Description

INITIA_KEY

No

—

Mnemonic (12/24 words), hex private key (0x...), or "ledger"

INITIA_KEY_INDEX

No

0

HD derivation index (for mnemonic/ledger)

INITIA_LEDGER_APP

No

ethereum

Ledger app: ethereum or cosmos

INITIA_NETWORK

No

mainnet

mainnet or testnet

AUTO_CONFIRM

No

false

Skip the server-side confirm gate for mutations (MCP only). See Security & Approvals.

INITIA_LOG_LEVEL

No

info

debug, info, warn, error

INITIA_USE_SCAN_API

No

false

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:

  1. 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.

  2. Server confirm gate (secondary). Every mutation tool takes a confirm flag (default false). Without it the tool only simulates and returns the estimated gas and decoded messages; it broadcasts only when called again with confirm: true. Because the agent supplies confirm, 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, and wasm_clear_admin are treated as destructive and always require explicit confirm: true, even when AUTO_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: with AUTO_CONFIRM=true they broadcast automatically.

  • All state-changing tools are annotated destructiveHint: true so clients that surface this hint can warn before running them. Note this MCP annotation is independent of the AUTO_CONFIRM bypass above: a tool can be destructiveHint: true and still auto-broadcast under AUTO_CONFIRM (only the three wasm admin tools are gated server-side).

  • INITIA_NETWORK defaults to mainnet — set INITIA_NETWORK=testnet for 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

chain_list

List all supported chains (L1 + L2 rollups)

chain_capabilities

Get chain VM type, features, and endpoints

chain_gas_prices

Current on-chain gas prices (L1 or L2)

account_get

Account info and balances

portfolio_get

Aggregated balances across all chains

address_validate

Validate bech32 or EVM address format

address_convert

Convert between bech32 and hex

delegation_get

Staking delegations, rewards, and unbonding

distribution_rewards

Pending staking rewards across validators

simulate_tx

Simulate a transaction and estimate gas

Token & Denom (7)

Tool

Description

token_search

Search tokens by symbol across all chains

token_list

List registered tokens on a chain

token_info

Token metadata (name, symbol, decimals) for any type

token_balance

Token balance for native, ERC20, CW20, or Move FA

amount_format

Format raw amount with decimals

denom_classify

Classify denomination type (native, ibc, evm, etc.)

denom_metadata

On-chain bank module metadata

Transaction (3)

Tool

Description

tx_get

Get transaction by hash with VM-aware decoding

tx_search

Search transactions (CometBFT query syntax)

tx_by_address

Recent transactions for an address

Validator & Staking (7)

Tool

Description

validator_list

List validators with status and voting power

validator_get

Detailed validator information

staking_pool

Network bonded/unbonded token totals

staking_annual_provisions

Current annual token provisions (inflation)

staking_manage

Delegate, undelegate, redelegate, or claim rewards

governance_vote

Vote on a governance proposal

proposal_list / proposal_get

List or get governance proposals

Bridge (14)

Tool

Description

bridge_route

Find optimal cross-chain transfer route

bridge_execute

Execute a cross-chain transfer via router

bridge_transfer_status

Track cross-chain transfer progress

bridge_list_chains

List bridgeable L2 chains

bridge_routable_assets

List assets available for routing

bridge_deposit / bridge_withdraw

Direct L1↔L2 OPInit deposit/withdraw

bridge_withdrawals / bridge_withdrawal_status

Query withdrawal status

opbridge_list / opbridge_get

OPInit bridge configuration

opbridge_token_pairs

L1↔L2 token pair mappings

opbridge_token_pair_by_l1_denom / opbridge_token_pair_by_l2_denom

Token pair lookup

IBC (3)

Tool

Description

ibc_channels

List IBC channels or find channel between two chains

ibc_denom_hash

Compute IBC denomination hash from path

ibc_transfer

Send tokens via IBC

Username (4)

Tool

Description

username_resolve

Resolve .init names ↔ addresses

username_record

Full .init username record

username_metadata

NFT metadata for .init username

username_check

Check username availability

Move VM (14)

Tool

Description

move_modules

List modules deployed at an address

move_module_abi

Get module ABI (functions, structs)

move_resources

List resources held by an address

move_resource_get

Query a specific resource

move_view

Call a view function (read-only)

move_execute

Execute an entry function

move_publish / move_script

Deploy module or run script

move_table_entry

Query a table entry

move_dex_pairs

List DEX liquidity pool pairs

move_denom_metadata / move_metadata_denom

Denom ↔ metadata conversion

move_bcs_encode / move_bcs_decode

BCS serialization utilities

EVM (10)

Tool

Description

evm_call

Call a contract function (read-only)

evm_send

Send a state-changing transaction

evm_deploy

Deploy a contract

evm_get_logs

Query event logs

evm_get_tx_receipt

Get transaction receipt

evm_get_block

Get block information

evm_get_code

Get contract bytecode (Minievm only)

evm_get_storage_at

Read storage slot (Minievm only)

evm_decode_revert

Decode revert reason

evm_decode_logs

Decode event logs with ABI

CosmWasm (12)

Tool

Description

wasm_query

Query a smart contract

wasm_execute

Execute a smart contract function

wasm_store_code

Upload contract bytecode

wasm_instantiate

Instantiate a contract

wasm_migrate

Migrate to a new code ID

wasm_update_admin / wasm_clear_admin

Admin management

wasm_contract_info / wasm_code_info

Contract/code metadata

wasm_contracts_by_code

List contracts from a code ID

wasm_contract_history

Migration history

wasm_raw_state

Raw key-value state

VIP (16)

Tool

Description

vip_stage_info

Current VIP stage and timing

vip_positions

Lock-staking positions

vip_voting_power

Gauge voting power

vip_vesting_positions

Vesting schedules with reward breakdowns

vip_vote_info

Vote allocations per bridge

vip_claimable_rewards

Claimable VIP rewards

vip_delegate / vip_undelegate / vip_redelegate

Lock-staking management

vip_extend_lock

Extend lock duration

vip_gauge_vote / vip_gauge_vote_by_amount

Gauge voting

vip_claim_rewards / vip_claim_staking_rewards

Reward claiming

vip_provide_and_delegate

LP + lock-delegate in one tx

vip_stableswap_provide_and_delegate

Stableswap LP + lock-delegate

Event Parsing (3)

Tool

Description

event_parse_tx

Parse Cosmos events from a transaction

event_parse_move

Decode Move module events

event_parse_wasm

Decode CosmWasm contract events

Ledger (2)

Tool

Description

ledger_status

Check Ledger device connection

ledger_verify_address

Display address on device for verification

Bank (1)

Tool

Description

bank_send

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 logging

Tools 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 signer

  • VM guard: Contract tools enforce VM compatibility — calling move_view on a MiniEVM chain returns a WRONG_VM error 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 --noEmit

License

Apache-2.0

Available Tools

113 tools
account_getA
Read-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_convertA
Read-only

Convert an address between bech32 (init1...) and hex (0x...) formats.

Inputs: address (required).

address_validateA
Read-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_formatA
Read-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_grantsA
Read-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_chainsA
Read-only

List all L2 chains that support OPInit bridging from/to L1.

Inputs: network.

bridge_routable_assetsA
Read-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_routeB
Read-only

Find the optimal cross-chain transfer route between two chains.

Inputs: amount (required), sourceChainId (required), sourceDenom (required), destChainId (required), +2 more.

bridge_transfer_statusA
Read-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_withdrawalsA
Read-only

List L2->L1 withdrawals for an address on a specific L2 chain.

Inputs: address (required), chain, limit, offset, +2 more.

bridge_withdrawal_statusA
Read-only

Get the status and details of a specific L2->L1 withdrawal by sequence number.

Inputs: sequence (required), chain, network.

chain_blockA
Read-only

Get block header and transaction list by height. Omit height to get the latest block.

Inputs: chain, height, network.

chain_block_resultsA
Read-only

Get block execution results (transaction results, validator updates, consensus param updates) for a given height.

Inputs: height (required), chain, network.

chain_capabilitiesA
Read-only

Get detailed capabilities for a specific chain: VM type, supported features, and endpoints.

Inputs: chain, network.

chain_gas_pricesA
Read-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_listA
Read-only

List all supported chains in the Initia ecosystem with their chain IDs and types.

Inputs: network.

delegation_getA
Read-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_classifyA
Read-only

Classify a token denomination into its type: native, ibc, evm, move, cw20, factory, or l2.

Inputs: denom (required).

denom_metadataA
Read-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_rewardsA
Read-only

Get pending staking rewards for a delegator across all validators.

Inputs: delegatorAddr (required), chain, network.

event_parse_moveB
Read-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_txB
Read-only

Parse and extract Cosmos events from a transaction. Optionally filter by event type.

Inputs: txHash (required), chain, eventType, network.

event_parse_wasmA
Read-only

Extract and decode CosmWasm contract events from a transaction. Filters wasm.* event types.

Inputs: txHash (required), chain, network.

evm_callA
Read-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_logsA
Read-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_revertA
Read-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_blockA
Read-only

Get EVM block information by number. Available on Minievm chains.

Inputs: chain, blockNumber, includeTransactions, network.

evm_get_codeA
Read-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_logsA
Read-only

Query EVM event logs with filters. Available on Minievm chains.

Inputs: chain, address, topics, fromBlock, +2 more.

evm_get_storage_atA
Read-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_receiptA
Read-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_allowancesA
Read-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_channelsA
Read-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_hashA
Read-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_statusA
Read-only

Check signer key type and Ledger device status

Inputs: no named parameters.

ledger_verify_addressA
Read-only

Display address on Ledger device for physical verification

Inputs: no named parameters.

move_bcs_decodeA
Read-only

Decode Move BCS bytes back to human-readable values.

Inputs: hexValues (required), types (required).

move_bcs_encodeA
Read-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_metadataA
Read-only

Convert a token denom to its Move metadata address. Available on Initia L1 and Minimove chains.

Inputs: denom (required), chain, network.

move_dex_pairsA
Read-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_denomA
Read-only

Convert a Move metadata address to its token denom. Available on Initia L1 and Minimove chains.

Inputs: metadata (required), chain, network.

move_module_abiA
Read-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_modulesA
Read-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_getA
Read-only

Query a Move resource at an address. Available on Initia L1 and Minimove chains.

Inputs: address (required), structTag (required), chain, network.

move_resourcesA
Read-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_entryB
Read-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_viewB
Read-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_getA
Read-only

Get detailed information about a specific OPInit bridge by its ID.

Inputs: bridgeId (required), network.

opbridge_listA
Read-only

List all OPInit bridges with their config. Returns paginated results (default 10).

Inputs: limit, offset, reverse, network.

opbridge_token_pair_by_l1_denomA
Read-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_denomA
Read-only

Find the L1 token for a given L2 denomination on a specific bridge.

Inputs: bridgeId (required), l2Denom (required), network.

opbridge_token_pairsA
Read-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_getA
Read-only

Get aggregated token balances across all chains (L1 + all L2s) for an address.

Inputs: address (required), network.

proposal_getA
Read-only

Get detailed information about a specific governance proposal.

Inputs: proposalId (required), chain, network.

proposal_listA
Read-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_txA
Read-only

Simulate a transaction to estimate gas and verify execution feasibility. Requires signer to be configured.

Inputs: msgs (required), chain, memo, network.

staking_annual_provisionsA
Read-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_poolA
Read-only

Get the network staking pool summary: total bonded tokens, unbonded tokens, and voting power weights. L1 only.

Inputs: network.

token_balanceA
Read-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_infoA
Read-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_listA
Read-only

List all registered tokens on a specific chain. Returns known assets from the registry with denom, symbol, decimals, and metadata.

Inputs: chain, network.

tx_by_addressA
Read-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_getA
Read-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.

username_checkA
Read-only

Check if a .init username is available for registration.

Inputs: name (required), network.

username_metadataA
Read-only

Get NFT metadata for a .init username (avatar, description, attributes).

Inputs: name (required), network.

username_recordA
Read-only

Get the full record for a .init username, including address and expiration.

Inputs: name (required), network.

username_resolveA
Read-only

Resolve .init names to addresses or addresses to .init names. For hex<->bech32 conversion, use address_convert instead.

Inputs: input (required), network.

validator_getA
Read-only

Get detailed information about a specific validator.

Inputs: validatorAddr (required), chain, network.

validator_listA
Read-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_rewardsA
Read-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_positionsA
Read-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_infoA
Read-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_positionsA
Read-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_infoA
Read-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_powerB
Read-only

Get VIP gauge voting power for an address.

Inputs: address (required), network.

wasm_clear_adminA
Destructive

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_infoA
Read-only

Get CosmWasm code info by code ID: creator, checksum, instantiate permission. Available on Miniwasm chains.

Inputs: codeId (required), chain, network.

wasm_contract_historyA
Read-only

Get migration history (init/migrate entries) for a CosmWasm contract. Available on Miniwasm chains.

Inputs: contractAddress (required), chain, network.

wasm_contract_infoA
Read-only

Get CosmWasm contract metadata: code_id, admin, label, creator. Available on Miniwasm chains.

Inputs: contractAddress (required), chain, network.

wasm_contracts_by_codeA
Read-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_migrateA
Destructive

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_queryA
Read-only

Query a CosmWasm smart contract (read-only). Available on Miniwasm chains.

Inputs: contractAddress (required), queryMsg (required), chain, network.

wasm_raw_stateB
Read-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_adminA
Destructive

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

    B3.2/5.0

    Scored across 113 tools

    Disambiguation3/5

    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.

    Naming Consistency3/5

    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.

    Tool Count1/5

    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.

    Completeness4/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers