Osmosis MCP Server
Used for HTTP API calls to interact with the Osmosis blockchain and related services
Used for type safety in the server implementation
Used for input validation of requests to the Osmosis blockchain
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., "@Osmosis MCP Server get my account balance for osmo1abc123xyz"
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.
Osmosis MCP Server
A comprehensive MCP (Model Context Protocol) server for interacting with the Osmosis blockchain. This server provides AI assistants with 158 tools covering every aspect of the Osmosis ecosystem, from basic blockchain queries to advanced DeFi operations, smart contract interactions, wallet management, direct transaction execution, and testnet utilities.
Features
Core Blockchain Operations
Query blockchain status, blocks, and transactions
Get account balances and token information
Retrieve chain parameters and module accounts
Monitor epochs and network state
Liquidity Pools & Trading
Query all pool types (Balancer, Stableswap, Concentrated Liquidity)
Get pool information, liquidity, fees, and APR
Estimate swaps and prepare trading transactions
Access historical price data and trading records
Concentrated Liquidity (CL)
Manage CL positions and liquidity ranges
Convert between prices and ticks
Query pool incentives and fee growth
Prepare position creation and management transactions
Staking & Governance
Query validators, delegations, and rewards
Prepare staking, unstaking, and redelegation transactions
Access governance proposals, votes, and tallies
Get staking parameters and commission rates
DeFi & Advanced Features
Time-Weighted Average Price (TWAP) calculations
Token lockups and superfluid staking
IBC denomination tracing
MEV/arbitrage tracking via ProtoRev
Smart Contracts (CosmWasm)
Query and execute smart contracts
Get contract information and history
Prepare contract instantiation and migration
Estimate gas fees for contract operations
Token Factory
Create custom tokens with metadata
Mint and burn token factory denominations
Manage token administration and parameters
Specialized Features
Downtime detection and validator preferences
IBC rate limiting and fee token management
🚀 NEW: Direct Transaction Execution (37 Tools)
Bank Operations: Send tokens, multi-send transactions
Governance: Submit proposals, vote, deposit on proposals
Lockup & Incentives: Lock tokens, claim rewards, create gauges
IBC Transfers: Cross-chain token transfers
Superfluid Staking: Liquid staking with LP tokens
Pool Operations: Create pools, advanced swaps
Token Factory: Create custom tokens, mint/burn
Module Administration: Parameter updates, upgrades
🔐 Wallet Management (6 Tools)
Generate new Osmosis wallets with BIP-39 mnemonics
Restore wallets from seed phrases
Validate addresses and mnemonics
Derive addresses from public keys
🧪 NEW: Testnet Utilities (3 Tools)
Check Network Status: Verify if on testnet/mainnet with safety warnings
Get Testnet Tokens: Complete guide to faucets and token sources
Testnet Faucet: Direct integration with Osmosis testnet faucet
Pool incentives and superfluid parameters
Related MCP server: Osmosis
Installation
# Clone the repository
git clone https://github.com/yourusername/osmosis-mcp-server.git
cd osmosis-mcp-server
# Install dependencies
npm install
# Build the project
npm run buildUsage
Running the Server
# Start the server
npm start
# Or run with the MCP inspector (for testing)
npm run inspectConfiguring in Claude Desktop
Open Claude Desktop
Go to Settings
Navigate to the MCP section
Add a new server with the following configuration:
Name: Osmosis Blockchain Server
Command: path/to/osmosis-mcp-server/build/index.js
Available Tools
The server exposes 158 tools organized into 12 categories:
📊 Blockchain Tools (9 tools)
get-blockchain-status- Get current blockchain statusget-account-balance- Get token balances for an addressget-epochs- Get epoch informationget-transaction- Get transaction details by hashget-latest-blocks- Get recent block informationget-token-info- Get token metadataget-supply- Get token supply informationget-chain-params- Get chain parametersget-module-accounts- Get module account information
🏊 Pool Tools (18 tools)
get-pool-info- Get pool informationget-all-pools- Get all liquidity poolsget-pool-spot-price- Get current spot priceestimate-swap- Estimate swap resultsget-incentivized-pools- Get pools with incentivesget-pool-incentives- Get pool incentive informationget-pool-type- Get pool type (balancer/stableswap/CL)get-historical-prices- Get historical price dataprepare-swap-transaction- Prepare swap transactionget-pool-total-shares- Get total LP sharesget-pool-liquidity- Get pool liquidity detailsget-pool-swap-fee- Get pool swap feesget-pool-exit-fee- Get pool exit feesget-pool-join-exit-records- Get join/exit historyget-pool-total-value-locked- Get pool TVLprepare-join-pool- Prepare join pool transactionprepare-exit-pool- Prepare exit pool transactionget-pool-apr- Get pool APR
🎯 Concentrated Liquidity Tools (15 tools)
get-cl-pools- Get all CL poolsget-cl-positions- Get CL positions for addressget-cl-position- Get specific CL position detailsget-cl-positions-by-pool- Get all positions in a poolget-cl-user-positions- Get user's CL positionsprice-to-tick- Convert price to ticktick-to-price- Convert tick to priceget-cl-pool-incentives- Get CL pool incentivesget-cl-pool-liquidity- Get CL pool liquidityget-cl-pool-tick-data- Get tick spacing and current tickget-cl-pool-fee-growth- Get fee growth statisticsprepare-cl-create-position- Prepare create position transactionprepare-cl-add-liquidity- Prepare add liquidity transactionprepare-cl-remove-liquidity- Prepare remove liquidity transactionget-cl-swap-estimates- Get CL-specific swap estimates
🥩 Staking Tools (15 tools)
get-validators- Get validator informationget-delegations- Get delegations for addressget-staking-rewards- Get pending staking rewardsget-unbonding-delegations- Get unbonding delegationsget-validator-delegations- Get all delegations to validatorget-validator-unbonding-delegations- Get validator unbonding delegationsget-validator-commission- Get validator commissionget-validator-self-delegation- Get validator self-delegationprepare-delegate- Prepare delegation transactionprepare-undelegate- Prepare undelegation transactionprepare-redelegate- Prepare redelegation transactionprepare-claim-rewards- Prepare claim rewards transactionget-staking-params- Get staking parametersget-slashing-params- Get slashing parametersget-distribution-params- Get distribution parameters
🗳️ Governance Tools (4 tools)
get-proposals- Get governance proposalsget-proposal-details- Get proposal detailsget-proposal-votes- Get proposal votesget-proposal-tally- Get proposal vote tally
💰 DeFi Tools (5 tools)
get-twap- Get Time-Weighted Average Priceget-lockups- Get token lockup informationget-superfluid-assets- Get superfluid staking assetsget-denoms-by-creator- Get token factory denoms by creatorget-ibc-denom-trace- Get IBC token source information
📜 CosmWasm Tools (20 tools)
get-wasm-codes- Get all uploaded WASM codesget-wasm-code-info- Get WASM code informationget-contracts-by-code- Get contracts by code IDget-contract-info- Get contract metadataquery-contract-state- Query contract stateget-contract-history- Get contract migration historyprepare-instantiate-contract- Prepare contract instantiationprepare-execute-contract- Prepare contract executionprepare-migrate-contract- Prepare contract migrationget-contract-code-id- Get contract code IDget-contract-admin- Get contract adminget-contract-label- Get contract labelquery-contract-raw- Query raw contract storageget-pinned-codes- Get pinned code IDsget-code-metadata- Get code metadatavalidate-contract-address- Validate contract addressestimate-instantiate-fee- Estimate instantiation gasestimate-execute-fee- Estimate execution gasget-contract-ibc-port- Get contract IBC portget-contract-events- Get contract events
🏭 Token Factory Tools (10 tools)
get-token-factory-denoms- Get all token factory denomsget-token-factory-denom-info- Get token factory denom metadataget-token-factory-creator- Get token creator addressprepare-create-token-factory-denom- Prepare create token transactionprepare-mint-token-factory-tokens- Prepare mint tokens transactionprepare-burn-token-factory-tokens- Prepare burn tokens transactionprepare-change-token-factory-admin- Prepare change admin transactionget-token-factory-params- Get token factory parametersvalidate-token-factory-denom- Validate token factory denomget-token-factory-total-supply- Get token total supply
⚡ ProtoRev Tools (8 tools)
get-protorev-profits-by-denom- Get MEV profits by denominationget-protorev-profits-by-tx- Get MEV profits by transactionget-protorev-statistics- Get overall MEV statisticsget-protorev-number-of-trades- Get ProtoRev trade countget-protorev-enabled- Check if ProtoRev is enabledget-protorev-developer-account- Get developer accountget-protorev-max-pool-points- Get max pool points per txget-protorev-pool-weights- Get pool weight configuration
🔧 Specialized Tools (11 tools)
get-downtime-detector-params- Get downtime detector parametersget-downtime-status- Get current downtime statusget-validator-set-preference- Get validator set preferencesget-ibc-rate-limits- Get IBC rate limiting infoget-mint-params- Get token minting parametersget-epoch-provisions- Get current epoch provisionsget-all-locks-by-type- Get locks by typeget-synthetic-locks-by-lock-id- Get synthetic lock detailsget-fee-tokens- Get accepted fee tokensget-pool-incentives-params- Get pool incentives parametersget-superfluid-params- Get superfluid parameters
🔐 Wallet Management Tools (6 tools)
generate-wallet- Generate new Osmosis wallet with mnemonicrestore-wallet-from-mnemonic- Restore wallet from seed phraseget-wallet-address- Get address from mnemonicvalidate-mnemonic- Validate BIP-39 mnemonic phrasevalidate-address- Validate Osmosis address formatderive-address-from-pubkey- Derive address from public key
🚀 Execution Tools (37 tools) - NEW!
Bank Operations (3 tools)
send- Send tokens to another addressmulti-send- Send tokens to multiple addressesset-send-enabled- Enable/disable sending for token types
Governance Operations (4 tools)
submit-proposal- Submit governance proposalvote-proposal- Vote on governance proposaldeposit-proposal- Deposit tokens to proposalclaim-community-pool- Claim community pool rewards
Lockup & Incentive Operations (6 tools)
lock-tokens- Lock tokens for incentive rewardsbegin-unlocking- Start unlocking specific locked tokensbegin-unlocking-all- Start unlocking all locked tokensunlock-period-lock- Unlock completed period locksclaim-incentives- Claim available incentive rewardscreate-gauge- Create new incentive gauge
IBC Operations (4 tools)
ibc-transfer- Transfer tokens across chainstimeout-packet- Handle IBC packet timeoutsacknowledge-packet- Acknowledge IBC packetsupdate-client- Update IBC light clients
Advanced Pool Operations (8 tools)
create-pool- Create new liquidity poolsjoin-swap-extern-amount-in- Advanced join-swap operationsjoin-swap-share-amount-out- Join-swap with share outputexit-swap-extern-amount-out- Advanced exit-swap operationsexit-swap-share-amount-in- Exit-swap with share inputcreate-cosmwasm-pool- Create CosmWasm-based poolsstable-swap- Perform stable asset swapsset-pool-weights- Adjust pool weights
Superfluid Staking Operations (4 tools)
superfluid-delegate- Delegate LP tokens via Superfluidsuperfluid-undelegate- Undelegate Superfluid tokenslock-and-superfluid-delegate- Lock and delegate in one txunlock-and-migrate-superfluid-tokens- Unlock and migrate
Token Factory Advanced Operations (3 tools)
set-token-metadata- Set custom token metadataforce-transfer- Admin force transfer tokensset-before-send-hook- Set token transfer hooks
Module Administration (5 tools)
update-params- Update module parametersupgrade-proposal- Submit software upgrade proposalcancel-upgrade- Cancel pending upgradeset-withdrawal-address- Set reward withdrawal addressfund-community-pool- Fund community pool
Example Interactions
Basic Blockchain Queries
Ask Claude:
What's the current status of the Osmosis blockchain?Can you tell me about the OSMO token on Osmosis?What's the balance of osmosis1abc...xyz?Pool and Trading Operations
Show me information about pool #1I want to swap 10 OSMO for ATOM. Can you estimate how much ATOM I would get?What pools have the highest APR right now?Help me prepare a transaction to join pool #678 with 100 OSMO and 50 ATOMConcentrated Liquidity Management
Show me all my concentrated liquidity positions for address osmosis1...Convert a price of 1.25 ATOM/OSMO to tick format for pool #1066Help me create a new CL position in the OSMO/USDC pool with a price range of $0.8 to $1.2Staking and Governance
Show me all active validators and their commission ratesWhat are my pending staking rewards for osmosis1...?What governance proposals are currently active?Prepare a transaction to delegate 100 OSMO to validator osmovaloper1...Smart Contract Interactions
Show me all smart contracts deployed with code ID 123Query the state of contract osmosis14... with message {"get_config": {}}Help me prepare a transaction to execute contract osmosis14... with the "swap" functionToken Factory Operations
Show me all custom tokens created by address osmosis1...Help me create a new token called "MyToken" with symbol "MTK"Prepare a transaction to mint 1000 MTK tokens to address osmosis1...Advanced Analytics
What are the current ProtoRev MEV profits for OSMO?Show me the time-weighted average price for OSMO/ATOM over the last 24 hoursWhat's the total value locked in pool #1?🚀 NEW: Direct Transaction Execution
Generate a new Osmosis wallet for meSend 10 OSMO from my wallet to osmosis1abc...xyz using my mnemonic phraseVote 'yes' on governance proposal #42 using my walletLock 100 OSMO for 14 days to earn incentive rewardsCreate an IBC transfer of 50 ATOM to the Cosmos HubSubmit a text governance proposal titled "Improve Pool Incentives"Security Notes
⚠️ UPDATED SECURITY MODEL:
Default Network: TESTNET (for safety during execution tools testing)
Execution Tools: Can sign and broadcast transactions directly using provided mnemonics
Query Tools: Read-only operations, no private key handling
Production Use: Set
OSMOSIS_NETWORK=mainnetenvironment variable for mainnetMnemonic Handling: Mnemonics are processed in-memory only, never stored
Testnet First: Always test with testnet before using mainnet funds
Development
# Run in development mode with auto-reloading
npm run dev
# Test with the MCP inspector
npm run inspect
# Run all tests
npm run test
# Validate everything works
npm run validateTool Categories Summary
Category | Count | Description |
📊 Blockchain | 9 | Core blockchain operations and queries |
🏊 Pools | 18 | Liquidity pool management and trading |
🎯 Concentrated Liquidity | 15 | Advanced CL position management |
🥩 Staking | 15 | Validator operations and delegation |
🗳️ Governance | 4 | Proposal voting and governance |
💰 DeFi | 5 | Advanced DeFi features and analytics |
📜 CosmWasm | 20 | Smart contract interactions |
🏭 Token Factory | 10 | Custom token creation and management |
⚡ ProtoRev | 8 | MEV and arbitrage tracking |
🔧 Specialized | 11 | Advanced module features |
🔐 Wallet | 6 | Wallet generation and management |
🚀 Execution | 37 | Direct transaction execution |
Total | 158 | Complete Osmosis ecosystem coverage |
Architecture
The server is built with:
TypeScript for type safety
@modelcontextprotocol/sdk for MCP protocol implementation
@cosmjs/stargate for Cosmos SDK interactions
osmojs for Osmosis-specific operations
axios for HTTP API calls
zod for input validation
Each tool category is modular and can be used independently, making the server highly maintainable and extensible.
License
MIT
Available Tools
161 toolsacknowledge-packetC
Acknowledge receipt of an IBC packet
Inputs: mnemonic (required), packet (required), acknowledgement (required), proofAcked (required), +4 more.
begin-unlockingC
Begin unlocking specific locked tokens
Inputs: mnemonic (required), id (required), coins, gas, +2 more.
begin-unlocking-allC
Begin unlocking all locked tokens for an account
Inputs: mnemonic (required), gas, gasPrice, memo.
cancel-upgradeC
Cancel a pending software upgrade
Inputs: mnemonic (required), authority (required), gas, gasPrice, +1 more.
check-testnet-statusB
Check if the current network is testnet and display testnet information
Inputs: no named parameters.
claim-community-poolB
Claim rewards from the community pool (validator commission)
Inputs: mnemonic (required), validatorAddress (required), gas, gasPrice, +1 more.
claim-incentivesC
Claim available incentive rewards from locked tokens
Inputs: mnemonic (required), lockIds, gas, gasPrice, +1 more.
create-cosmwasm-poolC
Create a CosmWasm-based pool
Inputs: mnemonic (required), codeId (required), instantiateMsg (required), gas, +2 more.
create-gaugeC
Create a new incentive gauge for rewarding locked tokens
Inputs: mnemonic (required), distributeTo (required), coins (required), startTime (required), +5 more.
create-poolC
Create a new liquidity pool on Osmosis
Inputs: mnemonic (required), poolType (required), poolAssets (required), swapFee (required), +8 more.
deposit-proposalC
Deposit tokens to a governance proposal
Inputs: mnemonic (required), proposalId (required), amount (required), denom, +3 more.
derive-address-from-pubkeyC
Derives an address from a public key
Inputs: publicKey (required), prefix.
estimate-execute-feeC
Estimates gas fees for contract execution
Inputs: sender (required), contractAddress (required), executeMsg (required), funds.
estimate-instantiate-feeB
Estimates gas fees for contract instantiation
Inputs: sender (required), codeId (required), initMsg (required), funds.
estimate-swapC
Estimates the result of a token swap
Inputs: poolId (required), tokenIn (required), tokenOut (required), amount (required).
exit-swap-extern-amount-outC
Exit pool by specifying exact token amount to receive
Inputs: mnemonic (required), poolId (required), tokenOut (required), shareInMaxAmount (required), +3 more.
force-transferB
Force transfer tokens (admin only)
Inputs: mnemonic (required), denom (required), amount (required), transferFromAddress (required), +4 more.
fund-community-poolC
Fund the community pool with tokens
Inputs: mnemonic (required), amount (required), gas, gasPrice, +1 more.
generate-walletC
Generates a new Osmosis wallet with mnemonic phrase
Inputs: wordCount, prefix.
get-account-balanceB
Returns token balances for an Osmosis address
Inputs: address (required).
get-all-locks-by-typeC
Returns lock information filtered by lock type
Inputs: lockType (required), address.
get-all-poolsC
Returns information about all liquidity pools
Inputs: limit.
get-blockchain-statusB
Returns the current status of the Osmosis blockchain
Inputs: no named parameters.
get-chain-paramsB
Returns current chain parameters for the Osmosis blockchain
Inputs: module.
get-cl-pool-fee-growthB
Returns fee growth statistics for a CL pool
Inputs: poolId (required).
get-cl-pool-incentivesC
Returns incentive information for a CL pool
Inputs: poolId (required).
get-cl-pool-liquidityC
Returns liquidity depth and distribution for a CL pool
Inputs: poolId (required), tickLower, tickUpper.
get-cl-poolsC
Returns all Concentrated Liquidity pools
Inputs: limit.
get-cl-pool-tick-dataB
Returns tick spacing and current tick for a CL pool
Inputs: poolId (required).
get-cl-positionB
Returns details of a specific Concentrated Liquidity position
Inputs: positionId (required).
get-cl-positionsB
Returns Concentrated Liquidity positions for an address
Inputs: address (required).
get-cl-positions-by-poolC
Returns all positions in a specific CL pool
Inputs: poolId (required), limit.
get-cl-swap-estimatesC
Returns swap estimates specifically for CL pools with price impact
Inputs: poolId (required), tokenIn (required), tokenOut (required), amount (required), +1 more.
get-cl-user-positionsB
Returns all CL positions for a user across all pools
Inputs: address (required), poolId.
get-code-metadataC
Returns metadata for a WASM code
Inputs: codeId (required).
get-contract-adminB
Returns the admin address of a contract
Inputs: contractAddress (required).
get-contract-code-idC
Returns the code ID of a contract
Inputs: contractAddress (required).
get-contract-eventsC
Returns events emitted by a contract
Inputs: contractAddress (required), eventType, limit.
get-contract-historyC
Returns the code migration history of a contract
Inputs: contractAddress (required).
get-contract-ibc-portB
Returns the IBC port ID for contracts with IBC capabilities
Inputs: contractAddress (required).
get-contract-infoB
Returns metadata about a specific contract
Inputs: contractAddress (required).
get-contract-labelC
Returns the label of a contract
Inputs: contractAddress (required).
get-contracts-by-codeB
Returns all contracts instantiated from a specific code ID
Inputs: codeId (required), limit.
get-delegationsC
Returns delegation information for an address
Inputs: delegatorAddress (required).
get-denoms-by-creatorB
Returns all token factory denoms created by an address
Inputs: creator (required).
get-distribution-paramsB
Returns the distribution module parameters
Inputs: no named parameters.
get-downtime-detector-paramsB
Returns downtime detector module parameters
Inputs: no named parameters.
get-downtime-statusC
Returns current downtime status for the chain
Inputs: no named parameters.
get-epoch-provisionsB
Returns current epoch provisions for token minting
Inputs: no named parameters.
get-epochsB
Returns information about all epochs
Inputs: no named parameters.
get-fee-tokensB
Returns list of accepted fee payment tokens
Inputs: no named parameters.
get-historical-pricesC
Returns historical price data for a token pair
Inputs: poolId (required), baseAssetDenom (required), quoteAssetDenom (required), startTime, +2 more.
get-ibc-denom-traceC
Returns the source information for an IBC token
Inputs: hash (required).
get-ibc-rate-limitsC
Returns IBC rate limiting information
Inputs: channelId.
get-incentivized-poolsB
Returns pools that have active incentives
Inputs: no named parameters.
get-latest-blocksC
Returns information about the most recent blocks
Inputs: limit.
get-lockupsC
Returns token lockup information for an address
Inputs: owner (required).
get-mint-paramsB
Returns token minting module parameters
Inputs: no named parameters.
get-module-accountsC
Returns information about module accounts on the chain
Inputs: name.
get-pinned-codesC
Returns all pinned code IDs
Inputs: limit.
get-pool-aprC
Returns the annual percentage rate (APR) for a pool
Inputs: poolId (required).
get-pool-exit-feeC
Returns the exit fee percentage for a pool
Inputs: poolId (required).
get-pool-incentivesC
Returns incentive information for a specific pool
Inputs: poolId (required).
get-pool-incentives-paramsB
Returns pool incentives module parameters
Inputs: no named parameters.
get-pool-infoC
Returns information about a specific liquidity pool
Inputs: poolId (required).
get-pool-join-exit-recordsC
Returns historical join and exit records for a pool
Inputs: poolId (required), address, limit.
get-pool-liquidityC
Returns detailed liquidity information for a pool
Inputs: poolId (required).
get-pool-spot-priceB
Returns the current spot price between two tokens in a pool
Inputs: poolId (required), baseAssetDenom (required), quoteAssetDenom (required).
get-pool-swap-feeC
Returns the swap fee percentage for a pool
Inputs: poolId (required).
get-pool-total-value-lockedB
Returns the total value locked (TVL) for a pool in USD
Inputs: poolId (required).
get-pool-typeB
Returns the type of a pool (balancer, stableswap, concentrated-liquidity)
Inputs: poolId (required).
get-proposal-detailsC
Returns detailed information about a specific governance proposal
Inputs: proposalId (required).
get-proposalsC
Returns governance proposals on Osmosis
Inputs: status.
get-proposal-tallyB
Returns the vote tally for a governance proposal
Inputs: proposalId (required).
get-proposal-votesC
Returns votes for a specific governance proposal
Inputs: proposalId (required), limit.
get-protorev-developer-accountB
Returns the developer account receiving ProtoRev profits
Inputs: no named parameters.
get-protorev-enabledB
Returns whether ProtoRev is currently enabled
Inputs: no named parameters.
get-protorev-max-pool-pointsB
Returns the maximum pool points per transaction for ProtoRev
Inputs: no named parameters.
get-protorev-number-of-tradesB
Returns the total number of ProtoRev trades executed
Inputs: denom.
get-protorev-pool-weightsC
Returns the pool weight configuration for ProtoRev
Inputs: poolType.
get-protorev-profits-by-denomC
Returns ProtoRev MEV profits aggregated by denomination
Inputs: denom, limit.
get-protorev-profits-by-txC
Returns ProtoRev MEV profits by transaction
Inputs: txHash (required).
get-protorev-statisticsB
Returns overall ProtoRev MEV statistics
Inputs: startDate, endDate.
get-slashing-paramsB
Returns the slashing module parameters
Inputs: no named parameters.
get-staking-paramsB
Returns the staking module parameters
Inputs: no named parameters.
get-staking-rewardsB
Returns pending staking rewards for an address
Inputs: delegatorAddress (required).
get-superfluid-assetsC
Returns available superfluid staking assets
Inputs: no named parameters.
get-superfluid-paramsB
Returns superfluid staking module parameters
Inputs: no named parameters.
get-supplyC
Returns the total supply information for a specific token
Inputs: denom (required).
get-synthetic-locks-by-lock-idC
Returns synthetic lock details by underlying lock ID
Inputs: lockId (required).
get-testnet-tokensB
Get instructions and links to obtain Osmosis testnet tokens for testing
Inputs: address, amount.
get-token-factory-creatorB
Returns the creator address of a token factory denomination
Inputs: denom (required).
get-token-factory-denom-infoB
Returns metadata for a token factory denomination
Inputs: denom (required).
get-token-factory-denomsC
Returns all token factory denominations
Inputs: creator, limit.
get-token-factory-paramsB
Returns the token factory module parameters
Inputs: no named parameters.
get-token-factory-total-supplyB
Returns the total supply of a token factory denomination
Inputs: denom (required).
get-token-infoB
Returns metadata about a specific token denomination
Inputs: denom (required).
get-transactionB
Returns detailed information about a specific transaction by hash
Inputs: hash (required).
get-twapC
Returns Time-Weighted Average Price for a pool
Inputs: poolId (required), baseAsset (required), quoteAsset (required), startTime (required), +1 more.
get-unbonding-delegationsC
Returns unbonding delegations for an address
Inputs: delegatorAddress (required).
get-validator-commissionC
Returns commission rates and earnings for a validator
Inputs: validatorAddress (required).
get-validator-delegationsC
Returns all delegations to a specific validator
Inputs: validatorAddress (required), limit.
get-validatorsC
Returns information about validators on Osmosis
Inputs: status.
get-validator-self-delegationB
Returns the self-delegation amount for a validator
Inputs: validatorAddress (required).
get-validator-set-preferenceC
Returns validator set preferences for a user
Inputs: address (required).
get-validator-unbonding-delegationsC
Returns all unbonding delegations from a validator
Inputs: validatorAddress (required), limit.
get-wallet-addressA
Gets the address from a mnemonic phrase without exposing the private key
Inputs: mnemonic (required), prefix, accountIndex.
get-wasm-code-infoC
Returns information about a specific WASM code
Inputs: codeId (required).
get-wasm-codesC
Returns all uploaded WASM codes
Inputs: limit, startAfter.
ibc-transferC
Transfer tokens across chains using IBC
Inputs: mnemonic (required), sourceChannel (required), token (required), receiver (required), +6 more.
join-swap-extern-amount-inC
Join pool by swapping exact amount in
Inputs: mnemonic (required), poolId (required), tokenIn (required), shareOutMinAmount (required), +3 more.
lock-and-superfluid-delegateC
Lock LP tokens and immediately delegate via Superfluid in one transaction
Inputs: mnemonic (required), coins (required), valAddr (required), gas, +2 more.
lock-tokensC
Lock tokens for incentive rewards on Osmosis
Inputs: mnemonic (required), coins (required), duration (required), gas, +2 more.
multi-sendC
Send tokens to multiple addresses in a single transaction
Inputs: mnemonic (required), inputs (required), outputs (required), gas, +2 more.
prepare-burn-token-factory-tokensC
Prepares a transaction to burn tokens
Inputs: sender (required), denom (required), amount (required), burnFrom.
prepare-change-token-factory-adminC
Prepares a transaction to change the admin of a token
Inputs: sender (required), denom (required), newAdmin (required).
prepare-cl-add-liquidityC
Prepares a transaction to add liquidity to an existing CL position
Inputs: positionId (required), sender (required), amount0 (required), amount1 (required), +2 more.
prepare-claim-rewardsC
Prepares a transaction to claim staking rewards
Inputs: delegatorAddress (required), validatorAddresses.
prepare-cl-create-positionC
Prepares a transaction to create a new CL position
Inputs: poolId (required), sender (required), lowerTick (required), upperTick (required), +3 more.
prepare-cl-remove-liquidityC
Prepares a transaction to remove liquidity from a CL position
Inputs: positionId (required), sender (required), liquidityAmount (required).
prepare-create-token-factory-denomC
Prepares a transaction to create a new token factory denomination
Inputs: sender (required), subdenom (required), metadata.
prepare-delegateB
Prepares a transaction to delegate tokens to a validator
Inputs: delegatorAddress (required), validatorAddress (required), amount (required).
prepare-execute-contractC
Prepares a transaction to execute a contract
Inputs: sender (required), contractAddress (required), executeMsg (required), funds.
prepare-exit-poolC
Prepares an unsigned transaction to exit a pool
Inputs: poolId (required), sender (required), shareInAmount (required), tokenOutMins (required).
prepare-instantiate-contractC
Prepares a transaction to instantiate a new contract
Inputs: sender (required), codeId (required), label (required), initMsg (required), +2 more.
prepare-join-poolC
Prepares an unsigned transaction to join a pool
Inputs: poolId (required), sender (required), tokensIn (required), shareOutMinAmount (required).
prepare-migrate-contractC
Prepares a transaction to migrate a contract to new code
Inputs: sender (required), contractAddress (required), newCodeId (required), migrateMsg (required).
prepare-mint-token-factory-tokensC
Prepares a transaction to mint new tokens
Inputs: sender (required), denom (required), amount (required), mintTo (required).
prepare-redelegateC
Prepares a transaction to redelegate tokens between validators
Inputs: delegatorAddress (required), validatorSrcAddress (required), validatorDstAddress (required), amount (required).
prepare-swap-transactionC
Prepares an unsigned transaction for token swap
Inputs: poolId (required), sender (required), tokenIn (required), tokenOutMinAmount (required), +1 more.
prepare-undelegateB
Prepares a transaction to undelegate tokens from a validator
Inputs: delegatorAddress (required), validatorAddress (required), amount (required).
price-to-tickC
Converts a price to a tick value for CL pools
Inputs: price (required), tickSpacing (required), baseAssetDenom (required), quoteAssetDenom (required).
query-contract-rawC
Queries raw contract storage by key
Inputs: contractAddress (required), key (required).
query-contract-stateC
Queries the state of a smart contract
Inputs: contractAddress (required), queryMsg (required).
restore-wallet-from-mnemonicC
Restores a wallet from an existing mnemonic phrase
Inputs: mnemonic (required), prefix, accountIndex.
sendC
Send tokens to another address
Inputs: mnemonic (required), toAddress (required), amount (required), gas, +2 more.
set-before-send-hookC
Set a before send hook for a token (admin only)
Inputs: mnemonic (required), denom (required), contractAddr (required), gas, +2 more.
set-pool-weightsC
Set new weights for a balancer pool (governance)
Inputs: mnemonic (required), poolId (required), poolAssets (required), gas, +2 more.
set-send-enabledC
Enable or disable sending for specific token denominations (admin only)
Inputs: mnemonic (required), sendEnabled (required), useDefaultFor, gas, +2 more.
set-token-metadataC
Set metadata for a token factory token
Inputs: mnemonic (required), denom (required), metadata (required), gas, +2 more.
set-withdrawal-addressC
Set reward withdrawal address for delegation rewards
Inputs: mnemonic (required), withdrawAddress (required), gas, gasPrice, +1 more.
stable-swapC
Perform a stable asset swap
Inputs: mnemonic (required), poolId (required), tokenIn (required), tokenOutDenom (required), +4 more.
submit-proposalC
Submit a governance proposal to the Osmosis network
Inputs: mnemonic (required), title (required), description (required), type (required), +8 more.
superfluid-delegateB
Delegate locked LP tokens to a validator using Superfluid staking
Inputs: mnemonic (required), lockId (required), valAddr (required), gas, +2 more.
superfluid-undelegateC
Undelegate Superfluid staked tokens
Inputs: mnemonic (required), lockId (required), gas, gasPrice, +1 more.
testnet-faucetC
Get Osmosis testnet tokens from the official faucet
Inputs: address (required), amount.
tick-to-priceB
Converts a tick value to a price for CL pools
Inputs: tick (required), baseAssetDenom (required), quoteAssetDenom (required).
timeout-packetC
Timeout an IBC packet that failed to be delivered
Inputs: mnemonic (required), packet (required), proofUnreceived (required), proofHeight (required), +4 more.
unlock-and-migrate-superfluid-tokensB
Unlock and migrate Superfluid tokens to new validator
Inputs: mnemonic (required), lockId (required), newValAddr (required), tokenOutMins (required), +3 more.
unlock-period-lockC
Unlock tokens from a completed lock period
Inputs: mnemonic (required), id (required), gas, gasPrice, +1 more.
update-clientC
Update an IBC light client with new header
Inputs: mnemonic (required), clientId (required), clientMessage (required), gas, +2 more.
update-paramsC
Update module parameters (governance/admin only)
Inputs: mnemonic (required), authority (required), module (required), params (required), +3 more.
upgrade-proposalC
Submit a software upgrade proposal
Inputs: mnemonic (required), title (required), description (required), name (required), +6 more.
validate-addressC
Validates if an address is a valid Osmosis address
Inputs: address (required), prefix.
validate-contract-addressC
Validates if an address is a valid contract
Inputs: address (required).
validate-mnemonicB
Validates if a mnemonic phrase is valid according to BIP-39
Inputs: mnemonic (required).
validate-token-factory-denomC
Validates if a denomination is a valid token factory denom
Inputs: denom (required).
vote-proposalC
Vote on a governance proposal
Inputs: mnemonic (required), proposalId (required), option (required), metadata, +3 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 161 tools
The tool set covers many distinct operations (e.g., get-pool-info vs. get-cl-pool-liquidity), but there is significant overlap in 'get' tools that could confuse agents. For example, get-pool-incentives and get-cl-pool-incentives are similar but for different pool types, and many 'get-' tools query related data (e.g., get-pool-spot-price vs. get-twap) with subtle distinctions that may lead to misselection without careful reading of descriptions.
Most tools follow a consistent verb-noun pattern with hyphens (e.g., get-account-balance, create-pool, prepare-swap-transaction), which is predictable. However, there are minor deviations like 'multi-send' (adjective-noun) and 'stable-swap' (adjective-noun) that break the verb-first convention, and a few tools like 'price-to-tick' and 'tick-to-price' use a different structure, slightly reducing consistency.
With 161 tools, the count is excessive for a single server, making it overwhelming and difficult for agents to navigate efficiently. While Osmosis is a complex blockchain with many features, this many tools likely includes redundant or overly granular operations (e.g., multiple 'get-' queries for similar data) that could be consolidated, indicating poor scoping and a heavy cognitive load.
The tool set provides comprehensive coverage of the Osmosis blockchain domain, including liquidity pools (creation, swapping, exiting), staking, governance, IBC, token factory, smart contracts, and queries. It supports full CRUD/lifecycle operations (e.g., create-pool, get-pool-info, set-pool-weights, prepare-exit-pool) and addresses all major functionalities without obvious gaps, ensuring agents can handle complex workflows effectively.
Maintenance
Related MCP Connectors
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
MCP server connecting AI agents to non-custodial staking data across 130+ networks.
AI Reasoning Cache & Consensus Layer with 11 MCP tools via Streamable HTTP.
Real-time planetary signal engine and Model Context Protocol (MCP) server for autonomous AI agents.
Related MCP Servers
- -licenseNot gradedqualityNot gradedmaintenanceComprehensive Model Context Protocol server that enables AI agents to interact with 30+ Ethereum-compatible blockchain networks, supporting token transfers, smart contract interactions, and ENS name resolution through a unified interface.1-
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol (MCP) server implementation that enables LLMs to interact with the Osmosis protocol, allowing for querying and transaction functionality through natural language.7MIT
- AlicenseBqualityDmaintenanceA comprehensive Model Context Protocol server that enables AI agents to interact with Starknet blockchain, query data, manage wallets, and work with smart contracts.2517 npm7MIT

Hashkey MCP Serverofficial
AlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that provides onchain tools for AI applications to interact with the Hashkey Network, enabling cryptocurrency transfers, smart contract deployment, and blockchain interactions.13 npm2MIT