Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| OSMOSIS_NETWORK | No | Network to connect to (testnet or mainnet). Default is testnet for safety during execution tools testing. | testnet |
Schema
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get-blockchain-status | Returns the current status of the Osmosis blockchain |
| get-account-balance | Returns token balances for an Osmosis address |
| get-epochs | Returns information about all epochs |
| get-transaction | Returns detailed information about a specific transaction by hash |
| get-latest-blocks | Returns information about the most recent blocks |
| get-token-info | Returns metadata about a specific token denomination |
| get-supply | Returns the total supply information for a specific token |
| get-chain-params | Returns current chain parameters for the Osmosis blockchain |
| get-module-accounts | Returns information about module accounts on the chain |
| get-pool-info | Returns information about a specific liquidity pool |
| get-all-pools | Returns information about all liquidity pools |
| get-pool-spot-price | Returns the current spot price between two tokens in a pool |
| estimate-swap | Estimates the result of a token swap |
| get-incentivized-pools | Returns pools that have active incentives |
| get-pool-incentives | Returns incentive information for a specific pool |
| get-pool-type | Returns the type of a pool (balancer, stableswap, concentrated-liquidity) |
| get-historical-prices | Returns historical price data for a token pair |
| prepare-swap-transaction | Prepares an unsigned transaction for token swap |
| get-pool-total-shares | Returns the total number of LP shares for a pool |
| get-pool-liquidity | Returns detailed liquidity information for a pool |
| get-pool-swap-fee | Returns the swap fee percentage for a pool |
| get-pool-exit-fee | Returns the exit fee percentage for a pool |
| get-pool-join-exit-records | Returns historical join and exit records for a pool |
| get-pool-total-value-locked | Returns the total value locked (TVL) for a pool in USD |
| prepare-join-pool | Prepares an unsigned transaction to join a pool |
| prepare-exit-pool | Prepares an unsigned transaction to exit a pool |
| get-pool-apr | Returns the annual percentage rate (APR) for a pool |
| get-cl-pools | Returns all Concentrated Liquidity pools |
| get-cl-positions | Returns Concentrated Liquidity positions for an address |
| get-cl-position | Returns details of a specific Concentrated Liquidity position |
| get-cl-positions-by-pool | Returns all positions in a specific CL pool |
| get-cl-user-positions | Returns all CL positions for a user across all pools |
| price-to-tick | Converts a price to a tick value for CL pools |
| tick-to-price | Converts a tick value to a price for CL pools |
| get-cl-pool-incentives | Returns incentive information for a CL pool |
| get-cl-pool-liquidity | Returns liquidity depth and distribution for a CL pool |
| get-cl-pool-tick-data | Returns tick spacing and current tick for a CL pool |
| get-cl-pool-fee-growth | Returns fee growth statistics for a CL pool |
| prepare-cl-create-position | Prepares a transaction to create a new CL position |
| prepare-cl-add-liquidity | Prepares a transaction to add liquidity to an existing CL position |
| prepare-cl-remove-liquidity | Prepares a transaction to remove liquidity from a CL position |
| get-cl-swap-estimates | Returns swap estimates specifically for CL pools with price impact |
| get-validators | Returns information about validators on Osmosis |
| get-delegations | Returns delegation information for an address |
| get-staking-rewards | Returns pending staking rewards for an address |
| get-unbonding-delegations | Returns unbonding delegations for an address |
| get-validator-delegations | Returns all delegations to a specific validator |
| get-validator-unbonding-delegations | Returns all unbonding delegations from a validator |
| get-validator-commission | Returns commission rates and earnings for a validator |
| get-validator-self-delegation | Returns the self-delegation amount for a validator |
| prepare-delegate | Prepares a transaction to delegate tokens to a validator |
| prepare-undelegate | Prepares a transaction to undelegate tokens from a validator |
| prepare-redelegate | Prepares a transaction to redelegate tokens between validators |
| prepare-claim-rewards | Prepares a transaction to claim staking rewards |
| get-staking-params | Returns the staking module parameters |
| get-slashing-params | Returns the slashing module parameters |
| get-distribution-params | Returns the distribution module parameters |
| get-proposals | Returns governance proposals on Osmosis |
| get-proposal-details | Returns detailed information about a specific governance proposal |
| get-proposal-votes | Returns votes for a specific governance proposal |
| get-proposal-tally | Returns the vote tally for a governance proposal |
| get-twap | Returns Time-Weighted Average Price for a pool |
| get-lockups | Returns token lockup information for an address |
| get-superfluid-assets | Returns available superfluid staking assets |
| get-denoms-by-creator | Returns all token factory denoms created by an address |
| get-ibc-denom-trace | Returns the source information for an IBC token |
| get-wasm-codes | Returns all uploaded WASM codes |
| get-wasm-code-info | Returns information about a specific WASM code |
| get-contracts-by-code | Returns all contracts instantiated from a specific code ID |
| get-contract-info | Returns metadata about a specific contract |
| query-contract-state | Queries the state of a smart contract |
| get-contract-history | Returns the code migration history of a contract |
| prepare-instantiate-contract | Prepares a transaction to instantiate a new contract |
| prepare-execute-contract | Prepares a transaction to execute a contract |
| prepare-migrate-contract | Prepares a transaction to migrate a contract to new code |
| get-contract-code-id | Returns the code ID of a contract |
| get-contract-admin | Returns the admin address of a contract |
| get-contract-label | Returns the label of a contract |
| query-contract-raw | Queries raw contract storage by key |
| get-pinned-codes | Returns all pinned code IDs |
| get-code-metadata | Returns metadata for a WASM code |
| validate-contract-address | Validates if an address is a valid contract |
| estimate-instantiate-fee | Estimates gas fees for contract instantiation |
| estimate-execute-fee | Estimates gas fees for contract execution |
| get-contract-ibc-port | Returns the IBC port ID for contracts with IBC capabilities |
| get-contract-events | Returns events emitted by a contract |
| get-token-factory-denoms | Returns all token factory denominations |
| get-token-factory-denom-info | Returns metadata for a token factory denomination |
| get-token-factory-creator | Returns the creator address of a token factory denomination |
| prepare-create-token-factory-denom | Prepares a transaction to create a new token factory denomination |
| prepare-mint-token-factory-tokens | Prepares a transaction to mint new tokens |
| prepare-burn-token-factory-tokens | Prepares a transaction to burn tokens |
| prepare-change-token-factory-admin | Prepares a transaction to change the admin of a token |
| get-token-factory-params | Returns the token factory module parameters |
| validate-token-factory-denom | Validates if a denomination is a valid token factory denom |
| get-token-factory-total-supply | Returns the total supply of a token factory denomination |
| get-protorev-profits-by-denom | Returns ProtoRev MEV profits aggregated by denomination |
| get-protorev-profits-by-tx | Returns ProtoRev MEV profits by transaction |
| get-protorev-statistics | Returns overall ProtoRev MEV statistics |
| get-protorev-number-of-trades | Returns the total number of ProtoRev trades executed |
| get-protorev-enabled | Returns whether ProtoRev is currently enabled |
| get-protorev-developer-account | Returns the developer account receiving ProtoRev profits |
| get-protorev-max-pool-points | Returns the maximum pool points per transaction for ProtoRev |
| get-protorev-pool-weights | Returns the pool weight configuration for ProtoRev |
| get-downtime-detector-params | Returns downtime detector module parameters |
| get-downtime-status | Returns current downtime status for the chain |
| get-validator-set-preference | Returns validator set preferences for a user |
| get-ibc-rate-limits | Returns IBC rate limiting information |
| get-mint-params | Returns token minting module parameters |
| get-epoch-provisions | Returns current epoch provisions for token minting |
| get-all-locks-by-type | Returns lock information filtered by lock type |
| get-synthetic-locks-by-lock-id | Returns synthetic lock details by underlying lock ID |
| get-fee-tokens | Returns list of accepted fee payment tokens |
| get-pool-incentives-params | Returns pool incentives module parameters |
| get-superfluid-params | Returns superfluid staking module parameters |
| generate-wallet | Generates a new Osmosis wallet with mnemonic phrase |
| restore-wallet-from-mnemonic | Restores a wallet from an existing mnemonic phrase |
| get-wallet-address | Gets the address from a mnemonic phrase without exposing the private key |
| validate-mnemonic | Validates if a mnemonic phrase is valid according to BIP-39 |
| validate-address | Validates if an address is a valid Osmosis address |
| derive-address-from-pubkey | Derives an address from a public key |
| submit-proposal | Submit a governance proposal to the Osmosis network |
| vote-proposal | Vote on a governance proposal |
| deposit-proposal | Deposit tokens to a governance proposal |
| claim-community-pool | Claim rewards from the community pool (validator commission) |
| lock-tokens | Lock tokens for incentive rewards on Osmosis |
| begin-unlocking | Begin unlocking specific locked tokens |
| begin-unlocking-all | Begin unlocking all locked tokens for an account |
| unlock-period-lock | Unlock tokens from a completed lock period |
| claim-incentives | Claim available incentive rewards from locked tokens |
| create-gauge | Create a new incentive gauge for rewarding locked tokens |
| ibc-transfer | Transfer tokens across chains using IBC |
| timeout-packet | Timeout an IBC packet that failed to be delivered |
| acknowledge-packet | Acknowledge receipt of an IBC packet |
| update-client | Update an IBC light client with new header |
| send | Send tokens to another address |
| multi-send | Send tokens to multiple addresses in a single transaction |
| set-send-enabled | Enable or disable sending for specific token denominations (admin only) |
| create-pool | Create a new liquidity pool on Osmosis |
| join-swap-extern-amount-in | Join pool by swapping exact amount in |
| join-swap-share-amount-out | Join pool by specifying exact LP shares to receive |
| exit-swap-extern-amount-out | Exit pool by specifying exact token amount to receive |
| exit-swap-share-amount-in | Exit pool by burning exact LP shares |
| create-cosmwasm-pool | Create a CosmWasm-based pool |
| stable-swap | Perform a stable asset swap |
| set-pool-weights | Set new weights for a balancer pool (governance) |
| superfluid-delegate | Delegate locked LP tokens to a validator using Superfluid staking |
| superfluid-undelegate | Undelegate Superfluid staked tokens |
| lock-and-superfluid-delegate | Lock LP tokens and immediately delegate via Superfluid in one transaction |
| unlock-and-migrate-superfluid-tokens | Unlock and migrate Superfluid tokens to new validator |
| set-token-metadata | Set metadata for a token factory token |
| force-transfer | Force transfer tokens (admin only) |
| set-before-send-hook | Set a before send hook for a token (admin only) |
| update-params | Update module parameters (governance/admin only) |
| upgrade-proposal | Submit a software upgrade proposal |
| cancel-upgrade | Cancel a pending software upgrade |
| set-withdrawal-address | Set reward withdrawal address for delegation rewards |
| fund-community-pool | Fund the community pool with tokens |
| get-testnet-tokens | Get instructions and links to obtain Osmosis testnet tokens for testing |
| testnet-faucet | Get Osmosis testnet tokens from the official faucet |
| check-testnet-status | Check if the current network is testnet and display testnet information |