Skip to main content
Glama

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 build

Usage

Running the Server

# Start the server
npm start

# Or run with the MCP inspector (for testing)
npm run inspect

Configuring in Claude Desktop

  1. Open Claude Desktop

  2. Go to Settings

  3. Navigate to the MCP section

  4. 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 status

  • get-account-balance - Get token balances for an address

  • get-epochs - Get epoch information

  • get-transaction - Get transaction details by hash

  • get-latest-blocks - Get recent block information

  • get-token-info - Get token metadata

  • get-supply - Get token supply information

  • get-chain-params - Get chain parameters

  • get-module-accounts - Get module account information

🏊 Pool Tools (18 tools)

  • get-pool-info - Get pool information

  • get-all-pools - Get all liquidity pools

  • get-pool-spot-price - Get current spot price

  • estimate-swap - Estimate swap results

  • get-incentivized-pools - Get pools with incentives

  • get-pool-incentives - Get pool incentive information

  • get-pool-type - Get pool type (balancer/stableswap/CL)

  • get-historical-prices - Get historical price data

  • prepare-swap-transaction - Prepare swap transaction

  • get-pool-total-shares - Get total LP shares

  • get-pool-liquidity - Get pool liquidity details

  • get-pool-swap-fee - Get pool swap fees

  • get-pool-exit-fee - Get pool exit fees

  • get-pool-join-exit-records - Get join/exit history

  • get-pool-total-value-locked - Get pool TVL

  • prepare-join-pool - Prepare join pool transaction

  • prepare-exit-pool - Prepare exit pool transaction

  • get-pool-apr - Get pool APR

🎯 Concentrated Liquidity Tools (15 tools)

  • get-cl-pools - Get all CL pools

  • get-cl-positions - Get CL positions for address

  • get-cl-position - Get specific CL position details

  • get-cl-positions-by-pool - Get all positions in a pool

  • get-cl-user-positions - Get user's CL positions

  • price-to-tick - Convert price to tick

  • tick-to-price - Convert tick to price

  • get-cl-pool-incentives - Get CL pool incentives

  • get-cl-pool-liquidity - Get CL pool liquidity

  • get-cl-pool-tick-data - Get tick spacing and current tick

  • get-cl-pool-fee-growth - Get fee growth statistics

  • prepare-cl-create-position - Prepare create position transaction

  • prepare-cl-add-liquidity - Prepare add liquidity transaction

  • prepare-cl-remove-liquidity - Prepare remove liquidity transaction

  • get-cl-swap-estimates - Get CL-specific swap estimates

🥩 Staking Tools (15 tools)

  • get-validators - Get validator information

  • get-delegations - Get delegations for address

  • get-staking-rewards - Get pending staking rewards

  • get-unbonding-delegations - Get unbonding delegations

  • get-validator-delegations - Get all delegations to validator

  • get-validator-unbonding-delegations - Get validator unbonding delegations

  • get-validator-commission - Get validator commission

  • get-validator-self-delegation - Get validator self-delegation

  • prepare-delegate - Prepare delegation transaction

  • prepare-undelegate - Prepare undelegation transaction

  • prepare-redelegate - Prepare redelegation transaction

  • prepare-claim-rewards - Prepare claim rewards transaction

  • get-staking-params - Get staking parameters

  • get-slashing-params - Get slashing parameters

  • get-distribution-params - Get distribution parameters

🗳️ Governance Tools (4 tools)

  • get-proposals - Get governance proposals

  • get-proposal-details - Get proposal details

  • get-proposal-votes - Get proposal votes

  • get-proposal-tally - Get proposal vote tally

💰 DeFi Tools (5 tools)

  • get-twap - Get Time-Weighted Average Price

  • get-lockups - Get token lockup information

  • get-superfluid-assets - Get superfluid staking assets

  • get-denoms-by-creator - Get token factory denoms by creator

  • get-ibc-denom-trace - Get IBC token source information

📜 CosmWasm Tools (20 tools)

  • get-wasm-codes - Get all uploaded WASM codes

  • get-wasm-code-info - Get WASM code information

  • get-contracts-by-code - Get contracts by code ID

  • get-contract-info - Get contract metadata

  • query-contract-state - Query contract state

  • get-contract-history - Get contract migration history

  • prepare-instantiate-contract - Prepare contract instantiation

  • prepare-execute-contract - Prepare contract execution

  • prepare-migrate-contract - Prepare contract migration

  • get-contract-code-id - Get contract code ID

  • get-contract-admin - Get contract admin

  • get-contract-label - Get contract label

  • query-contract-raw - Query raw contract storage

  • get-pinned-codes - Get pinned code IDs

  • get-code-metadata - Get code metadata

  • validate-contract-address - Validate contract address

  • estimate-instantiate-fee - Estimate instantiation gas

  • estimate-execute-fee - Estimate execution gas

  • get-contract-ibc-port - Get contract IBC port

  • get-contract-events - Get contract events

🏭 Token Factory Tools (10 tools)

  • get-token-factory-denoms - Get all token factory denoms

  • get-token-factory-denom-info - Get token factory denom metadata

  • get-token-factory-creator - Get token creator address

  • prepare-create-token-factory-denom - Prepare create token transaction

  • prepare-mint-token-factory-tokens - Prepare mint tokens transaction

  • prepare-burn-token-factory-tokens - Prepare burn tokens transaction

  • prepare-change-token-factory-admin - Prepare change admin transaction

  • get-token-factory-params - Get token factory parameters

  • validate-token-factory-denom - Validate token factory denom

  • get-token-factory-total-supply - Get token total supply

⚡ ProtoRev Tools (8 tools)

  • get-protorev-profits-by-denom - Get MEV profits by denomination

  • get-protorev-profits-by-tx - Get MEV profits by transaction

  • get-protorev-statistics - Get overall MEV statistics

  • get-protorev-number-of-trades - Get ProtoRev trade count

  • get-protorev-enabled - Check if ProtoRev is enabled

  • get-protorev-developer-account - Get developer account

  • get-protorev-max-pool-points - Get max pool points per tx

  • get-protorev-pool-weights - Get pool weight configuration

🔧 Specialized Tools (11 tools)

  • get-downtime-detector-params - Get downtime detector parameters

  • get-downtime-status - Get current downtime status

  • get-validator-set-preference - Get validator set preferences

  • get-ibc-rate-limits - Get IBC rate limiting info

  • get-mint-params - Get token minting parameters

  • get-epoch-provisions - Get current epoch provisions

  • get-all-locks-by-type - Get locks by type

  • get-synthetic-locks-by-lock-id - Get synthetic lock details

  • get-fee-tokens - Get accepted fee tokens

  • get-pool-incentives-params - Get pool incentives parameters

  • get-superfluid-params - Get superfluid parameters

🔐 Wallet Management Tools (6 tools)

  • generate-wallet - Generate new Osmosis wallet with mnemonic

  • restore-wallet-from-mnemonic - Restore wallet from seed phrase

  • get-wallet-address - Get address from mnemonic

  • validate-mnemonic - Validate BIP-39 mnemonic phrase

  • validate-address - Validate Osmosis address format

  • derive-address-from-pubkey - Derive address from public key

🚀 Execution Tools (37 tools) - NEW!

Bank Operations (3 tools)

  • send - Send tokens to another address

  • multi-send - Send tokens to multiple addresses

  • set-send-enabled - Enable/disable sending for token types

Governance Operations (4 tools)

  • submit-proposal - Submit governance proposal

  • vote-proposal - Vote on governance proposal

  • deposit-proposal - Deposit tokens to proposal

  • claim-community-pool - Claim community pool rewards

Lockup & Incentive Operations (6 tools)

  • lock-tokens - Lock tokens for incentive rewards

  • begin-unlocking - Start unlocking specific locked tokens

  • begin-unlocking-all - Start unlocking all locked tokens

  • unlock-period-lock - Unlock completed period locks

  • claim-incentives - Claim available incentive rewards

  • create-gauge - Create new incentive gauge

IBC Operations (4 tools)

  • ibc-transfer - Transfer tokens across chains

  • timeout-packet - Handle IBC packet timeouts

  • acknowledge-packet - Acknowledge IBC packets

  • update-client - Update IBC light clients

Advanced Pool Operations (8 tools)

  • create-pool - Create new liquidity pools

  • join-swap-extern-amount-in - Advanced join-swap operations

  • join-swap-share-amount-out - Join-swap with share output

  • exit-swap-extern-amount-out - Advanced exit-swap operations

  • exit-swap-share-amount-in - Exit-swap with share input

  • create-cosmwasm-pool - Create CosmWasm-based pools

  • stable-swap - Perform stable asset swaps

  • set-pool-weights - Adjust pool weights

Superfluid Staking Operations (4 tools)

  • superfluid-delegate - Delegate LP tokens via Superfluid

  • superfluid-undelegate - Undelegate Superfluid tokens

  • lock-and-superfluid-delegate - Lock and delegate in one tx

  • unlock-and-migrate-superfluid-tokens - Unlock and migrate

Token Factory Advanced Operations (3 tools)

  • set-token-metadata - Set custom token metadata

  • force-transfer - Admin force transfer tokens

  • set-before-send-hook - Set token transfer hooks

Module Administration (5 tools)

  • update-params - Update module parameters

  • upgrade-proposal - Submit software upgrade proposal

  • cancel-upgrade - Cancel pending upgrade

  • set-withdrawal-address - Set reward withdrawal address

  • fund-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 #1
I 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 ATOM

Concentrated 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 #1066
Help me create a new CL position in the OSMO/USDC pool with a price range of $0.8 to $1.2

Staking and Governance

Show me all active validators and their commission rates
What 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 123
Query the state of contract osmosis14... with message {"get_config": {}}
Help me prepare a transaction to execute contract osmosis14... with the "swap" function

Token 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 hours
What's the total value locked in pool #1?

🚀 NEW: Direct Transaction Execution

Generate a new Osmosis wallet for me
Send 10 OSMO from my wallet to osmosis1abc...xyz using my mnemonic phrase
Vote 'yes' on governance proposal #42 using my wallet
Lock 100 OSMO for 14 days to earn incentive rewards
Create an IBC transfer of 50 ATOM to the Cosmos Hub
Submit 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=mainnet environment variable for mainnet

  • Mnemonic 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 validate

Tool 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 tools
acknowledge-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.

exit-swap-share-amount-inC

Exit pool by burning exact LP shares

Inputs: mnemonic (required), poolId (required), tokenOutDenom (required), shareInAmount (required), +4 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-sharesB

Returns the total number of LP shares 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.

join-swap-share-amount-outC

Join pool by specifying exact LP shares to receive

Inputs: mnemonic (required), poolId (required), tokenInDenom (required), shareOutAmount (required), +4 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

    C2.9/5.0

    Scored across 161 tools

    Disambiguation3/5

    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.

    Naming Consistency4/5

    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.

    Tool Count2/5

    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.

    Completeness5/5

    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

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • -
      license
      Not graded
      quality
      Not graded
      maintenance
      Comprehensive 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
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol (MCP) server implementation that enables LLMs to interact with the Osmosis protocol, allowing for querying and transaction functionality through natural language.
      7
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      A 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 npm
      2
      MIT