# Ekubo Protocol (remote · mcp.ekubo.org) Token and pool data, swap quotes, and unsigned transaction plans for Ekubo and other DeFi protocols. - Trust score: 66/100 (medium) - Registry status: active - Liveness: live - Owner verified: no - Last scored: 2026-11-05 ## Components - remote · `mcp.ekubo.org`: 66/100 (this document), [markdown](https://verifymcp.io/servers/ekuboprotocol-ekubo/mcp.md), [page](https://verifymcp.io/servers/ekuboprotocol-ekubo/mcp) ## Channel facts - Endpoint: `https://mcp.ekubo.org/mcp` - Transports: `streamable-http` - Auth: `none` - Version: `0.54.0` ## Trust breakdown How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog) Scored 2026-11-05. - **Endpoint Security**: 66/100 - The endpoint's TLS certificate is valid, in date, and uses a strong key. - Authorisation not fully verified: no authorisation is required to call this server, and 14 tool(s) never declared a destructiveHint. The MCP spec treats an absent hint as destructive by default, so we cannot call this surface safe. - HTTPS is enforced; there's no plaintext access path. - The HSTS (Strict-Transport-Security) header is present. - DNSSEC is configured correctly; the domain's records validate against the full chain to the root. - **Transport & Reachability**: 100/100 - Verified streamable-http transport via a live MCP handshake. - **Schema Quality & AI Usability**: 74/100 - 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name). - AI-judged instruction clarity (good). - Context-footprint check failed: tool/resource definitions use about 17546 tokens (~151/item across 116 items; 99 tools + 17 resources), over budget; trim descriptions and params. - Usage-examples check failed: none of the tools include examples. - **Stability & Change Management**: 3/100 - Stability observed for 1 of 30 days with no destabilising changes; credit accrues until the full window elapses. - **Tool Coverage**: 95/100 - 100% of tools have a non-trivial description (not blank, and not just the tool's name). - 82% of tool parameters carry a description. - Structured output schemas are declared (100% of tools); any adoption earns full credit. - **Tool Safety**: 75/100 - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured. - 0 of 14 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation; "get_value_transfer_status" implies "transfer" and declares readOnlyHint instead, contradicting what its own name says it does. - An AI judge read all 101 captured unit(s) of tool text and found none that tries to manipulate the model reading it. - **Capabilities**: 100/100 - Implements a current MCP spec version (2026-07-28). ## Install ### How do I install the Ekubo Protocol MCP server? Ekubo Protocol is a hosted endpoint at https://mcp.ekubo.org/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation. ### Claude ```bash claude mcp add --transport http ekuboprotocol-ekubo 'https://mcp.ekubo.org/mcp' ``` ### Cursor ```json { "mcpServers": { "ekuboprotocol-ekubo": { "url": "https://mcp.ekubo.org/mcp" } } } ``` ### VS Code ```json { "servers": { "ekuboprotocol-ekubo": { "type": "http", "url": "https://mcp.ekubo.org/mcp" } } } ``` ### Codex ```toml [mcp_servers.ekuboprotocol-ekubo] url = "https://mcp.ekubo.org/mcp" ``` ### opencode ```json { "$schema": "https://opencode.ai/config.json", "mcp": { "ekuboprotocol-ekubo": { "type": "remote", "url": "https://mcp.ekubo.org/mcp", "enabled": true } } } ``` ### OpenClaw ```bash openclaw mcp add ekuboprotocol-ekubo --url 'https://mcp.ekubo.org/mcp' --transport streamable-http ``` ### Hermes ```yaml mcp_servers: ekuboprotocol-ekubo: url: "https://mcp.ekubo.org/mcp" ``` ### Netclaw ```json { "McpServers": { "ekuboprotocol-ekubo": { "Transport": "http", "Url": "https://mcp.ekubo.org/mcp" } } } ``` ### Vellum ```bash assistant mcp add ekuboprotocol-ekubo -t streamable-http -u 'https://mcp.ekubo.org/mcp' ``` ### Other ```json { "mcpServers": { "ekuboprotocol-ekubo": { "type": "http", "url": "https://mcp.ekubo.org/mcp" } } } ``` The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs. ## Changelog Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims. ### 2026-11-05 (score 66, 0) - [functional improvement] Stability: unverified → 0.03 ### 2026-11-04 (score 66) First indexed and scored. ## MCP tools (99) ### `list_tokens` (~226 tokens) List Ekubo tokens First step for symbol-based swaps, including tokenized stocks and stablecoins: list canonical Ekubo tokens by descending visibility_priority, so the preferred token wins an ambiguous symbol. Use search for a symbol prefix or suffix and min_visibility_priority to reach tokens the interface hides. Input parameters: - `after_token` (string): Keep only tokens whose (chain_id, address) pair sorts after this :
identifier. Results are ordered by visibility_priority rather than by that pair, so this filters the candidate se… - `chain_id` (integer|string): Restrict the list to one EVM chain; omit to list tokens across every indexed chain - `min_visibility_priority` (integer): Lowest visibility_priority to include; defaults to 0, the interface threshold. Pass a negative value to reach tokens the interface hides - `page_size` (integer): Maximum tokens to return; defaults to 20 - `search` (string): Case-insensitive token symbol prefix or suffix match; omit to list the whole canonical set. Symbols only, not names or addresses Output parameters: - `tokens` (array) ### `export_tokens` (~147 tokens) Export Ekubo tokens for a wallet Return a token_list_reference envelope (chain ID, address, symbol, name, decimals) and its count, with no entries, so a wallet can import token names; pass it unchanged as the wallet tool's reference argument. complete=false means the export is a prefix of the chain's list. Use list_tokens to read entries yourself. Input parameters: - `chain_id` (integer|string): Export only this chain; almost always pass it, since a wallet holds names for the chain it is on. Ethereum alone has about 5,600 tokens - `max_tokens` (integer): Defaults to 1,000, what a wallet accepts in one import; a larger export is refused whole, not truncated Output parameters: - `complete` (boolean) - `count` (integer) - `token_list_reference` (object): artifact_reference; pass unchanged ### `get_token` (~48 tokens) Get an Ekubo token Fetch canonical token metadata for an exact chain and address. Input parameters: - `address` (string, required): EVM or Starknet token address (hex) - `chain_id` (integer|string, required): EVM chain ID Output parameters: - `token` (object) ### `get_tokens` (~49 tokens) Get multiple Ekubo tokens Fetch canonical metadata for up to 1,000 token identifiers in one batch request, preserving input order; identifiers absent from the canonical list are omitted. Input parameters: - `tokens` (array, required): Entries may span chains Output parameters: - `tokens` (array) ### `get_quotes_with_plans` (~740 tokens) Get swap or bridge quotes with execution plans A quote, execution plan, simulation or wallet approval is not permission to trade. Robinhood Stock Tokens are tokenised debt securities subject to issuer restrictions and applicable law. Before requesting signatures or submitting approvals or trades, establish the user's relevant jurisdiction and eligibility, including location, residence or entity incorporation, US-person status under Regulation S, any person for whose account or benefit the transaction is made, and issuer Prohibited Investor restrictions. Never infer these facts from an agent or server IP. If required facts or asset-policy coverage are unknown, do not proceed. Only the user or an authorized representative of the actual investor may provide an explicit factual attestation; an agent must not attest on their behalf. A known prohibited fact cannot be overridden by attestation. An attestation is not a license, legal exemption or substitute for required screening. Keep the attestation client-side; do not send it to the quote API or MCP server. No blanket disposal exemption applies. Quote EVM swaps: Ekubo/0x same-chain; Across/LayerZero/LI.FI cross-chain. For plans, supply sender and exactly one protection: whole slippage_bps or exact-input max_output_loss in output base units. Omit all three for indicative quotes. Pass the chosen execution.execution_plan_reference unchanged to wallet simulation; show that result and send the same simulation for owner authorization. Re-quote only after revert, expiry or changed request; never retry reverted bytes or widen protection. For all/max swaps use the wallet's exact balance. Compare amount_out and native_fee (LayerZero charges it separately). Track LayerZero/LI.FI delivery with get_value_transfer_status. unavailable_sources reports provider failures; execution_unavailable reports plan failures. Input parameters: - `amount` (string, required): Base units (positive decimal integer) - `chain_id` (integer|string, required): EVM chain ID - `destination_chain_id` (integer|string): Destination chain; defaults to chain_id for a same-chain swap - `include_raw_quotes` (boolean): Echo raw provider responses; only to diagnose a provider - `max_output_loss` (string): Exact-input loss budget from quoted output, output-token base units as a decimal integer string; requires sender, omit slippage_bps. Ekubo: exact subtraction. 0x: two quotes, floor budget to whole pp… - `quote_type` (string, required) - `recipient` (string): Defaults to sender (address) - `sender` (string): Transaction sender; pass with exactly one of slippage_bps or max_output_loss for plans (address) - `slippage_bps` (integer): Whole-bps calldata bound: 0.1% = 10. With sender supply this OR max_output_loss. Honor user preference; size near gas value / notional * 10,000. For positive sub-bps budgets use max_output_loss, not… - `swap_deadline_minutes` (integer): Ekubo router route deadline; default 30 - `token_in` (string, required): Raw EVM address or CAIP-10 eip155::
; all-zeroes denotes the native token - `token_out` (string, required): Raw EVM address or CAIP-10 eip155::
; all-zeroes denotes the native token Output parameters: - `jurisdiction` (object): jurisdiction metadata (ekubo-token-jurisdictions-v2): coverage, execution_hold, restricted_jurisdictions, per-asset classification - `quotes` (array) ### `get_value_transfer_status` (~207 tokens) Track a LayerZero or LI.FI cross-chain transfer Report whether an executed LayerZero or LI.FI transfer has been delivered; its origin receipt alone does not mean the user has the funds. Poll every 15 to 30 seconds while settled is false (it draws on the quote budget). UNKNOWN or NOT_FOUND right after submission usually means not yet indexed. For LI.FI, read substatus: REFUNDED and PARTIAL report as status DONE. Across transfers are not tracked here. Input parameters: - `destination_chain_id` (integer|string): Destination chain; lifi only - `origin_chain_id` (integer|string): Origin chain; lifi only, narrows the lookup - `quote_id` (string): The executed option's provider_quote_id; required for layerzero - `source` (string): The executed quote's source; defaults to layerzero - `transaction_hash` (string): Origin transaction hash; required for lifi, and pass it for layerzero once known (some routes need it) (bytes32 hex) Output parameters: - `execution_history` (array) - `explorer_url` (string|null) - `origin_transaction_hash` (string|null) - `polling` (object) - `quote_id` (string|null) - `settled` (boolean) - `source` (string) - `source_url` (string) - `status` (string) - `substatus` (string|null) - `substatus_message` (string|null) ### `prepare_ve33_vote` (~232 tokens) Prepare one ve(3,3) NFT vote change Compile one actively voted ve-token into multiple allocations. Unconditionally claims its current pool first, then splits and changes votes in one atomic batch of decodable VeToken steps. Nothing is burned, withdrawn, or transferred: the source keeps a stake and every additional allocation is a newly minted NFT with the same lock end. Prefer the portfolio reallocation workflow for complete state validation. Input parameters: - `allocations` (array, required) - `chain_id` (integer|string, required): With ve_token, from get_ve33_allocations (STONX: 4663), not the wallet's chain - `current_vote` (object, required): Required active indexed vote; its pool is claimed unconditionally before any split, clear, or replacement vote - `salt_nonce` (string, required): User-selected nonce used to derive deterministic, replay-detectable split salts (bytes32 hex) - `sender` (string, required): address - `source_amount` (string, required): Base units (positive decimal integer) - `source_ve_id` (string, required): decimal integer - `unallocated_permille` (integer, required) - `ve_token` (string, required): address Output parameters: - `execution_plan_reference` (object): artifact_reference; pass unchanged ### `prepare_ve33_extend` (~273 tokens) Prepare a ve-token extension Prepare a direct extension for an unvoted VeToken or an atomic claim-and-extend call when current_pool_key identifies an active vote, so pending voter fees are preserved. Extending moves the stake to a later end time and clears its vote — that is why the claim is compounded into the same call. A stake's end time only ever moves later, here and everywhere else in Ve33. No NFT is burned and no stake leaves the wallet; re-vote afterwards with prepare_ve33_vote. max_duration=true must be the user's explicit choice. Input parameters: - `chain_id` (integer|string, required): With ve_token, from get_ve33_allocations (STONX: 4663), not the wallet's chain - `current_pool_key` (object): Active pool key when voted; the MCP claims fees atomically before extension. Omit only for an unvoted VeToken. PoolKey {token0, token1, config} or {token0, token1, fee, tick_spacing, extension, stabl… - `duration_seconds` (integer) - `max_duration` (boolean) - `sender` (string, required): address - `ve_id` (string, required): decimal integer - `ve_token` (string, required): address Output parameters: - `execution_plan_reference` (object): artifact_reference; pass unchanged ### `prepare_ve33_stake` (~186 tokens) Prepare a new ve-token stake Create a new VeToken stake with an exact stake-token approval. Max duration is the safe default for new stakes; an explicit shorter duration is optional and no existing NFT, vote, fee balance, or ownership is changed. Input parameters: - `amount` (string, required): Base units (positive decimal integer) - `chain_id` (integer|string, required): With ve_token, from get_ve33_allocations (STONX: 4663), not the wallet's chain - `duration_seconds` (integer) - `max_duration` (boolean): Defaults to true when duration_seconds is omitted; set false only with an explicit duration_seconds - `salt` (string, required): User-selected salt for a deterministic, replay-detectable VeToken ID (bytes32 hex) - `sender` (string, required): address - `stake_token` (string, required): address - `ve_token` (string, required): address Output parameters: - `execution_plan_reference` (object): artifact_reference; pass unchanged ### `prepare_ve33_split` (~158 tokens) Prepare a ve-token split Split a source ve-token with an explicit salt and return the deterministic child token ID; the source vote is preserved with reduced weight and the child starts unvoted with the same lock end. Non-destructive: no stake leaves the wallet, no NFT is burned, no vote is cleared, and no fees are discarded. Input parameters: - `amount` (string, required): Base units (positive decimal integer) - `chain_id` (integer|string, required): With ve_token, from get_ve33_allocations (STONX: 4663), not the wallet's chain - `salt` (string, required): bytes32 hex - `sender` (string, required): address - `ve_id` (string, required): decimal integer - `ve_token` (string, required): address Output parameters: - `execution_plan_reference` (object): artifact_reference; pass unchanged ### `prepare_ve33_claim_fees` (~140 tokens) Prepare ve-token fee claims Generate one call, or an atomic batch of decodable VeToken steps, claiming voter fees from one or more ve-tokens. Fees only: votes, stake amounts, lock ends, and NFT ownership are all unchanged, so this is always safe to run before any other ve(3,3) action. Input parameters: - `chain_id` (integer|string, required): With ve_token, from get_ve33_allocations (STONX: 4663), not the wallet's chain - `claims` (array, required) - `recipient` (string): address - `sender` (string, required): address - `ve_token` (string, required): address Output parameters: - `execution_plan_reference` (object): artifact_reference; pass unchanged ### `prepare_ve33_reinvest` (~315 tokens) Prepare ve-token fee reinvestment Build the safe phased workflow for 'reinvest my fees': automatically claim all active voter fees, prepare one exact-input swap per claimed non-stake token, then increase one VeToken or every existing active allocation without changing ownership or replacing votes. phase=swap returns jurisdiction metadata inline on the result and on every child swap; it is not permission to trade. For a nonempty restricted_jurisdictions list, follow its execution_notice before requesting any signature. Phases run in order after each confirms: claim (omit claims to discover every active allocation; keep the pre-claim balance snapshots), swap with only the exact claimed deltas, never a pre-existing balance, then stake_all with the refreshed state_id and the measured STONX output. Input parameters: - `amount` (string): Stake token base units (decimal integer) - `chain_id` (integer|string, required): With ve_token, from get_ve33_allocations (STONX: 4663), not the wallet's chain - `claims` (array) - `current_state_id` (string): bytes32 hex - `fee_balances` (array) - `phase` (string, required) - `sender` (string, required): address - `slippage_bps` (integer) - `source` (string) - `stake_token` (string): address - `swap_deadline_minutes` (integer): Ekubo router route deadline; default 30 - `ve_id` (string): decimal integer - `ve_token` (string, required): address Output parameters: - `exact_input_full_balance_swaps` (array) - `jurisdiction` (object): jurisdiction metadata (ekubo-token-jurisdictions-v2): coverage, execution_hold, restricted_jurisdictions, per-asset classification - `phase` (string) ### `prepare_ve33_claim_all_fees` (~152 tokens) Prepare all ve-token fee claims Discover every active vote on VeTokens owned by the sender and generate one atomic batch of decodable VeToken steps claiming all indexed pool fees, with ownerOf and voteState validation calldata. Fees only: votes, stake amounts, lock ends, and NFT ownership are all unchanged. Input parameters: - `chain_id` (integer|string, required): With ve_token, from get_ve33_allocations (STONX: 4663), not the wallet's chain - `recipient` (string): Fee recipient; defaults to sender for claimPoolFeesToSelf (address) - `sender` (string, required): Owner whose indexed VeTokens and active votes should be discovered (address) - `ve_token` (string, required): address Output parameters: - `execution_plan_reference` (object): artifact_reference; pass unchanged ### `prepare_ve33_clear_vote` (~212 tokens) Prepare ve-token vote clearing Remove the active vote from one or more ve-tokens, claiming each stake's current pool fees immediately before its clearVote in one atomic batch. Use this instead of raw clearVote calldata: Ve33 discards pending voter fees when a stake's weight goes to zero, and a current_pool_key that is not the stake's active pool reverts the whole batch. Stake amount, lock end and NFT ownership are untouched; the stake stops directing emissions and earning that pool's voter fees. Prefer prepare_ve33_reallocation when votes move to other pools. See ekubo://docs/ve33-workflow. Input parameters: - `chain_id` (integer|string, required): With ve_token, from get_ve33_allocations (STONX: 4663), not the wallet's chain - `recipient` (string): Fee recipient; defaults to sender for claimPoolFeesToSelf (address) - `sender` (string, required): address - `ve_token` (string, required): address - `votes` (array, required) Output parameters: - `execution_plan_reference` (object): artifact_reference; pass unchanged ### `get_ve33_allocations` (~233 tokens) Show Ekubo STONX / ve(3,3) allocations Use for requests such as 'show all my Ekubo STONX allocations'. The production Ekubo ve(3,3) deployment is the STONX voting system, so pass only owner to select its production chain and canonical VeToken automatically. Returns every pool, selected swap fee, NFT, applied vote weight, totals, state_id, and an onchain_validation request explicitly marked not_executed until the client runs its eth_call. Pass chain_id and ve_token together only for another deployment. Input parameters: - `chain_id` (integer|string): Optional with ve_token; omit both for the production Ekubo STONX deployment - `owner` (string, required): Connected EVM wallet whose complete Ekubo STONX/VeToken allocation should be shown; the server cannot infer 'my', so ask the user when no wallet address is available - `ve_token` (string): Optional with chain_id; omit both for the canonical STONX VeToken 0x9d7008E169D040B6c0140eb92E7cA82B12643497 (address) Output parameters: - `onchain_validation` (object) ### `get_stonx_allocation_recommendation` (~267 tokens) Get suggested STONX allocations Return a provider-neutral STONX allocation recommendation with an emissions_efficiency KPI per pool and an executable target list (exactly 10,000 bps, at most 25 Ve33 pools). The snapshot refreshes daily; read snapshot_age_seconds. voter with ve33_emission_state makes targets voter-optimal and keeps the neutral plan as provider_targets; without the emission state, execution_ready is false and local_read_requirement says what to read. The tool constructs no transaction. To apply it, require execution_ready=true, then pass its targets, the state_id from get_ve33_allocations for the connected wallet, and strategy=compact_max_lock to prepare_ve33_reallocation. Input parameters: - `max_emission_share_per_fee_share` (number): Prune above this emission share / retained fee share; default 3 - `prune_low_efficiency` (boolean): Withhold prune candidates and redistribute their weight - `ve33_emission_state` (object): {current_timestamp, current_emission_rate, total_remaining_emissions}: decimal strings decoded locally from getEmissionState (rate is Q32) via local_read_requirement; omit on the first call - `voter` (object): With ve33_emission_state, makes targets voter-optimal Output parameters: - `chain_id` (string) - `execution_ready` (boolean) - `recommendation_id` (string) - `recommendations` (array) - `schema_version` (string) - `snapshot_at` (string) - `targets` (array) ### `prepare_ve33_reallocation` (~367 tokens) Prepare atomic ve(3,3) reallocation Compile a reviewed current allocation into at most 25 target pool-weight shares as one atomic batch of decodable VeToken steps. The default path only claims, splits, and votes: nothing is burned, no lock is extended, and nothing is withdrawn. The optional compact_max_lock strategy fee-safely consolidates active NFTs, extends the survivor to four years, then creates exactly one voting NFT per target; it burns every merged source NFT and lengthens the lock, and explicitly discloses both. Show the get_ve33_allocations result first and pass its exact state_id; hand the wallet the survivor, every burned source, the extension, and the decoded calls. See ekubo://docs/ve33-workflow. Input parameters: - `chain_id` (integer|string, required): With ve_token, from get_ve33_allocations (STONX: 4663), not the wallet's chain - `current_state_id` (string, required): Exact state_id returned by get_ve33_allocations; preparation fails if indexed state changed (bytes32 hex) - `salt_nonce` (string, required): User-selected nonce for deterministic child VeToken IDs created by required splits (bytes32 hex) - `sender` (string, required): VeToken owner that will execute the atomic batch (address) - `strategy` (string): Defaults to preserve_existing_locks. compact_max_lock explicitly claims fees, consolidates active stake into one surviving NFT, extends it to four years, then creates exactly one voting NFT per targe… - `targets` (array, required): At most 25 targets. compact_max_lock creates one final voting VeToken per target; preserve_existing_locks may require multiple NFTs per target to keep expiry-cohort decay proportional. - `ve_token` (string, required): address Output parameters: - `execution_plan_reference` (object): artifact_reference; pass unchanged ### `get_positions_by_owner` (~118 tokens) Get Ekubo positions by owner Enumerate an owner's indexed Ekubo position NFTs with pool keys, bounds, liquidity, indexed pool state and rewards. For fresh onchain state, pass each current_state_reads[].read_calls_reference to wallet_batch_eth_call as a value in the same code block; each position's current_state.state_call_id joins results[].id. Input parameters: - `chain_id` (integer|string): EVM chain ID - `owner` (string, required): address - `page` (integer) - `page_size` (integer) - `state` (string) Output parameters: - `current_state_reads` (array) ### `get_pool` (~92 tokens) Get an Ekubo pool Resolve a chain/core/pool ID to its verified PoolKey, decoded config and indexed pool state. For fresh sqrtRatio, tick and liquidity, pass current_state_query.read_calls_reference unchanged to wallet_batch_eth_call. Input parameters: - `chain_id` (integer|string, required): EVM chain ID - `core_address` (string, required): address - `pool_id` (string, required): Pool ID (decimal or 0x-hex integer) Output parameters: - `current_state_query` (object) ### `get_pool_liquidity` (~83 tokens) Get Ekubo pool liquidity depth Return tick-level net liquidity deltas for one exact chain/core/pool ID. Accumulate the deltas in ascending tick order to reconstruct active liquidity depth. Input parameters: - `chain_id` (integer|string, required): EVM chain ID - `core_address` (string, required): address - `pool_id` (string, required): Pool ID (decimal or 0x-hex integer) Output parameters: - `chain_id` (string) - `core_address` (string) - `liquidity_deltas` (array) - `pool_id` (string) - `pool_id_decimal` (string) ### `list_pool_keys` (~163 tokens) List Ekubo pool keys Discover initialized pools for one chain and Core deployment, ordered by pool_id with keyset pagination, optionally filtered by token, pair or extension. Each pool_id is re-derived from its PoolKey and each row carries the indexed state (null until indexed). Input parameters: - `after_pool_id` (string): Previous page's next_after_pool_id (decimal or 0x-hex integer) - `chain_id` (integer|string, required): EVM chain ID - `core_address` (string, required): Core deployment (address) - `extension` (string): Zero address = extensionless - `page_size` (integer): Pools per page - `token_a` (string): Pools containing this token (address) - `token_b` (string): With token_a, the exact pair (address) Output parameters: - `chain_id` (string) - `core_address` (string) - `core_generation` (string) - `page` (object) - `pools` (array) ### `derive_pool_id` (~57 tokens) Derive an Ekubo pool ID Pack or accept an exact PoolKey config and derive pool_id = keccak256(abi.encode(PoolKey)). The uint64 Q64 fee is string-only so JavaScript cannot silently round it. Input parameters: - `pool_key` (object, required) Output parameters: - `decoded_config` (object) - `pool_id` (string) - `pool_id_decimal` (string) - `pool_key` (object) ### `decode_pool_config` (~58 tokens) Decode an Ekubo pool config Decode the packed bytes32 extension, exact uint64 Q64 fee, concentrated/stableswap discriminator, and tick spacing or stableswap parameters. The fee is never returned as a JSON number. Input parameters: - `config` (string, required): bytes32 hex Output parameters: - `config` (string) - `discriminator_bit_set` (boolean) - `extension` (string) - `fee` (string) - `fee_hex` (string) - `pool_type` (string) - `stableswap_params` (object|null) - `tick_spacing` (integer|null) - `type_config` (string) ### `get_position` (~144 tokens) Get complete Ekubo position details Hydrate one owner position: pool key, bounds, liquidity, pool state, NFT metadata, history, rewards, token prices, and a pending read of current principal, fees or Ve33 rewards and owner. Pass current_state_query.read_calls_reference as a value to wallet_batch_eth_call in the same code block; current_state_query.state_call_id joins results[].id. Input parameters: - `chain_id` (integer|string, required): EVM chain ID - `owner` (string, required): Current owner (address) - `positions_address` (string, required): Ekubo Positions or Ve33Positions manager (address) - `token_id` (string, required): Position NFT ID (decimal or 0x-hex integer) Output parameters: - `current_state_query` (object) ### `get_position_pool_candidates` (~134 tokens) Find pools for an LP position List indexed pools for a token pair with verified PoolKeys and pool IDs, Core generation, pool type, extension, 24-hour TVL/volume/fee stats and the right Positions or Ve33Positions manager. Input parameters: - `chain_id` (integer|string, required): EVM chain ID - `core_address` (string): address - `extension` (string): address - `min_tvl_usd` (number): TVL floor; default 0 keeps tiny pools visible - `pool_type` (string) - `token_a` (string, required): Either order (address) - `token_b` (string, required): address Output parameters: - `candidate_count` (integer) - `candidates` (array) - `chain_id` (string) - `pair` (object) - `tokens` (array) ### `prepare_lp_position_deposit` (~388 tokens) Prepare an LP position deposit Prepare a v3 position mint or add_liquidity, initializing a new pool at initial_tick when requested, with every approval, refund and cleanup step. Ekubo ticks use base 1.000001, so tick = ln(price in base units) x 10^6 and a Uniswap-style 1.0001 calculation is 100x too small. The token ratio follows the range and current price: do every swap first, re-read the tick with the pool's current_state_query, then mint once. If the wallet lacks one side, execute that swap separately and size the deposit from the measured balance after its receipt, never a quoted output. See ekubo://docs/lp-position-workflow. Input parameters: - `chain_id` (integer|string, required): EVM chain ID - `core_address` (string, required): v3 Core address - `initial_tick` (integer): Uninitialized pool only: initializes at this tick - `max_amount0` (string, required): Max token0 base units; 0 for single-sided (decimal integer) - `max_amount1` (string, required): Max token1 base units; 0 for single-sided (decimal integer) - `mode` (string) - `pool_id` (string): Omit when pool_key is supplied (decimal or 0x-hex integer) - `pool_initialized` (boolean): false only for a new pool to initialize here - `pool_key` (object): Required for an uninitialized pool. PoolKey {token0, token1, config}: token addresses (zero = native), bytes32 config - `sender` (string, required): address - `slippage_bps` (integer, required): User-selected liquidity slippage - `tick_lower` (integer, required) - `tick_upper` (integer, required) - `token_id` (string): add_liquidity only (decimal or 0x-hex integer) Output parameters: - `execution_plan_reference` (object): artifact_reference; pass unchanged ### `prepare_lp_position_earnings_claim` (~147 tokens) Prepare an LP fee or reward claim Prepare collection of all accrued fees from an owned standard position or rewards from an owned Ve33 position, keeping its liquidity and NFT. Run its current_state_query first: require every inner call to succeed and the decoded owner to equal expected_owner, and pass the decoded fees or rewards to the wallet with the plan. Input parameters: - `chain_id` (integer|string, required): EVM chain ID - `positions_address` (string, required): Positions or Ve33Positions manager (address) - `recipient` (string): Defaults to sender (address) - `sender` (string, required): Position owner (address) - `token_id` (string, required): Position NFT ID (decimal or 0x-hex integer) Output parameters: - `execution_plan_reference` (object): artifact_reference; pass unchanged ### `prepare_lp_position_withdraw` (~116 tokens) Prepare one or more LP position withdrawals Prepare partial or full withdrawals from one or more owned positions in one plan, collecting fees or Ve33 rewards and keeping the NFTs. Read each position's current_state_query first and request no more liquidity than it decodes; require every inner call to succeed and owner to equal expected_owner. Hand the wallet every principal and earnings estimate and recipient. Input parameters: - `chain_id` (integer|string, required): EVM chain ID - `sender` (string, required): Owner of every position (address) - `withdrawals` (array, required): One entry per position Output parameters: - `execution_plan_reference` (object): artifact_reference; pass unchanged ### `prepare_wrap_unwrap` (~96 tokens) Prepare a direct wrapped-native wrap or unwrap Prepare a direct wrapped-native deposit or withdrawal on a chain with a verified wrapped native token. The response names the wrapped token, which is not WETH everywhere (BNB Chain wraps BNB, Polygon POL, Monad MON). Input parameters: - `amount` (string, required): Base units (positive decimal integer) - `chain_id` (integer|string, required): EVM chain ID - `direction` (string, required) - `sender` (string, required): address Output parameters: - `execution_plan_reference` (object): artifact_reference; pass unchanged ### `prepare_transfers` (~118 tokens) Prepare a batch of token transfers Prepare one atomic-capable plan of 1 to 4,096 ordered native, ERC-20, ERC-721 and ERC-1155 transfers on one EVM chain, mixed freely. Returns a compact summary and the execution_plan_reference. Input parameters: - `chain_id` (integer|string, required): EVM chain ID - `sender` (string, required): Nonzero owner of every asset (address) - `transfers` (array, required): One to 4096 ordered, optionally mixed native, ERC-20, ERC-721, or ERC-1155 transfers Output parameters: - `execution_plan_reference` (object): artifact_reference; pass unchanged ### `prepare_lp_position_transfer` (~94 tokens) Prepare an LP position transfer Prepare the exact safeTransferFrom transaction for an owned LP position and include pending ownership validation. The position, liquidity, and unclaimed earnings move together. Input parameters: - `chain_id` (integer|string, required): EVM chain ID - `positions_address` (string, required): address - `recipient` (string, required): address - `sender` (string, required): address - `token_id` (string, required): decimal or 0x-hex integer Output parameters: - `execution_plan_reference` (object): artifact_reference; pass unchanged ### `prepare_fix_pool_price` (~159 tokens) Prepare a pool price correction Run the interface-equivalent phased fix-price workflow: provide exact pending pool-price read calldata, then exact router quote calldata, then approvals and target-price execution calldata. The wallet never constructs a route or transaction. Input parameters: - `base_token` (string, required): Token; zero address = native - `chain_id` (integer|string, required): EVM chain ID - `core_address` (string, required): address - `pending_current_sqrt_ratio` (string): decimal integer - `pool_id` (string, required): decimal or 0x-hex integer - `quote_result` (object) - `sender` (string, required): address - `swap_deadline_minutes` (integer): Ekubo router route deadline; default 30 - `target_price` (string, required) Output parameters: - `execution_plan_reference` (object): artifact_reference; pass unchanged ### `prepare_twamm_order` (~203 tokens) Prepare a TWAMM or DCA order Prepare one or more TWAMM order splits with approvals and native value as one atomic batch. details.token_id is the order's id before anything is sent: keep it, because prepare_twamm_order_collection and prepare_twamm_order_stop are keyed by it and orders are not enumerable by owner. Start and end times must be multiples of 256 seconds near the present, widening in powers of 16 further out. Input parameters: - `buy_token` (string, required): Token; zero address = native - `chain_id` (integer|string, required): EVM chain ID - `deadline_seconds` (integer) - `orders` (array, required) - `pending_timestamp` (string, required): decimal integer - `salt` (string): Fixes the order's token id; omit to derive it from the request. Supply one only when identical orders need distinct ids (bytes32 hex) - `sell_token` (string, required): Token; zero address = native - `sender` (string, required): address Output parameters: - `execution_plan_reference` (object): artifact_reference; pass unchanged ### `prepare_twamm_order_collection` (~95 tokens) Prepare TWAMM proceeds collection Prepare collection of every selected order key through the exact current or legacy Orders manager, as one atomic batch of decodable steps, with pending owner validation. Input parameters: - `chain_id` (integer|string, required): EVM chain ID - `order_keys` (array, required) - `orders_address` (string, required): address - `sender` (string, required): address - `token_id` (string, required): decimal or 0x-hex integer Output parameters: - `execution_plan_reference` (object): artifact_reference; pass unchanged ### `prepare_twamm_order_stop` (~102 tokens) Prepare stopping a TWAMM order Prepare the interface's complete stop flow: collect every selected order and decrease every still-active sale rate in one atomic batch of decodable steps. Input parameters: - `chain_id` (integer|string, required): EVM chain ID - `orders` (array, required) - `orders_address` (string, required): address - `pending_timestamp` (string, required): decimal integer - `sender` (string, required): address - `token_id` (string, required): decimal or 0x-hex integer Output parameters: - `execution_plan_reference` (object): artifact_reference; pass unchanged ### `prepare_twamm_virtual_orders` (~82 tokens) Prepare TWAMM virtual-order execution Prepare the permissionless lockAndExecuteVirtualOrders maintenance call for a current or legacy TWAMM pool. Input parameters: - `chain_id` (integer|string, required): EVM chain ID - `pool_key` (object, required): PoolKey {token0, token1, config}: token addresses (zero = native), bytes32 config - `sender` (string, required): address Output parameters: - `execution_plan_reference` (object): artifact_reference; pass unchanged ### `prepare_auction_create` (~171 tokens) Prepare auction creation Pack the exact interface auction config and prepare mint plus sellAmountByAuction, including approval or native value and deterministic token ID. Input parameters: - `auction_duration` (integer, required) - `buy_token` (string, required): Token; zero address = native - `chain_id` (integer|string, required): EVM chain ID - `creator_fee_q32` (string, required): decimal integer - `graduation_pool_fee_q64` (string, required): decimal integer - `graduation_pool_tick_spacing` (integer, required) - `min_boost_duration` (integer, required) - `salt` (string, required): bytes32 hex - `sell_amount` (string, required): Base units (positive decimal integer) - `sell_token` (string, required): Token; zero address = native - `sender` (string, required): address - `start_time` (string, required): decimal integer Output parameters: - `execution_plan_reference` (object): artifact_reference; pass unchanged ### `prepare_auction_complete` (~114 tokens) Prepare auction completion Prepare permissionless auction completion and, when necessary, graduation-pool initialization in the same atomic batch. Input parameters: - `auction_key` (object, required): PoolKey {token0, token1, config}: token addresses (zero = native), bytes32 config - `chain_id` (integer|string, required): EVM chain ID - `graduation_pool_initialized` (boolean, required) - `launch_pool_tick` (integer) - `sender` (string, required): address - `token_id` (string, required): decimal or 0x-hex integer Output parameters: - `execution_plan_reference` (object): artifact_reference; pass unchanged ### `prepare_auction_creator_proceeds` (~92 tokens) Prepare auction creator proceeds collection Prepare collection of creator proceeds for an auction NFT with pending owner validation. Input parameters: - `auction_key` (object, required): PoolKey {token0, token1, config}: token addresses (zero = native), bytes32 config - `chain_id` (integer|string, required): EVM chain ID - `sender` (string, required): address - `token_id` (string, required): decimal or 0x-hex integer Output parameters: - `execution_plan_reference` (object): artifact_reference; pass unchanged ### `prepare_manual_pool_boost` (~153 tokens) Prepare a manual pool boost Compute the exact Q32 boost rates and prepare all token approvals, native value, and boost calldata used by the interface. Input parameters: - `amount0` (string, required): Total token0 base units over the boost (decimal integer) - `amount1` (string, required): Total token1 base units over the boost (decimal integer) - `chain_id` (integer|string, required): EVM chain ID - `end_time` (string, required): Unix seconds, after start_time (decimal integer) - `pool_key` (object, required): PoolKey {token0, token1, config}: token addresses (zero = native), bytes32 config - `sender` (string, required): address - `start_time` (string, required): Unix seconds (decimal integer) Output parameters: - `execution_plan_reference` (object): artifact_reference; pass unchanged ### `prepare_oracle_capacity_expansion` (~71 tokens) Prepare oracle capacity expansion Prepare the interface's permissionless Oracle expandCapacity call for one ERC-20 token. Input parameters: - `chain_id` (integer|string, required): EVM chain ID - `min_capacity` (integer, required) - `sender` (string, required): address - `token` (string, required): Token; zero address = native Output parameters: - `execution_plan_reference` (object): artifact_reference; pass unchanged ### `prepare_approval_revocations` (~68 tokens) Prepare ERC-20 approval revocations Prepare every approve(spender,0) as an exact ordered multi-transaction execution plan. The wallet must not discover or construct the transaction list. Input parameters: - `approvals` (array, required) - `chain_id` (integer|string, required): EVM chain ID - `sender` (string, required): address Output parameters: - `execution_plan_reference` (object): artifact_reference; pass unchanged ### `get_rewards_claims_by_owner` (~49 tokens) Get incentive rewards claims by owner Fetch canonical reward-claim records and supply the exact per-chain isClaimed/isAvailable eth_call list used by the interface before preparing claim transactions. Input parameters: - `owner` (string, required): address Output parameters: - `onchain_validation` (object) ### `prepare_rewards_claim` (~58 tokens) Prepare incentive reward claims Prepare one Incentives claim or the interface's allow-failure Multicall3 aggregate for multiple claims. Input parameters: - `chain_id` (integer|string, required): EVM chain ID - `claims` (array, required) - `sender` (string, required): address Output parameters: - `execution_plan_reference` (object): artifact_reference; pass unchanged ### `prepare_revenue_buybacks` (~87 tokens) Prepare revenue buyback maintenance Prepare the exact selected ended-order collections, protocol-fee withdrawals, and token rolls in interface order within one atomic batch of decodable steps. Input parameters: - `chain_id` (integer|string, required): EVM chain ID - `ended_order_collects` (array, required) - `protocol_fee_pairs` (array, required) - `roll_tokens` (array, required) - `sender` (string, required): address Output parameters: - `execution_plan_reference` (object): artifact_reference; pass unchanged ### `prepare_ve33_increase_stake` (~159 tokens) Prepare increasing a ve-token stake Prepare the exact approval/native value and increaseStakeAmount call while preserving the existing vote and fee accounting. Non-destructive: the vote is resized rather than cleared, no fees are discarded, and no NFT is burned. The added stake takes the NFT's existing lock end, so it cannot be withdrawn before that time. Input parameters: - `amount` (string, required): Base units (positive decimal integer) - `chain_id` (integer|string, required): With ve_token, from get_ve33_allocations (STONX: 4663), not the wallet's chain - `sender` (string, required): address - `stake_token` (string, required): address - `ve_id` (string, required): decimal integer - `ve_token` (string, required): address Output parameters: - `execution_plan_reference` (object): artifact_reference; pass unchanged ### `prepare_ve33_merge` (~229 tokens) Prepare merging ve-token stakes Prepare fee-safe merging of one or more source NFTs into a destination, including required claims and the selected resulting vote in one atomic batch of decodable steps. Destructive to the sources: each source's stake moves to the destination, its vote is cleared, and the source NFT is burned, so its fees are claimed first and its ID is reported in the plan. The destination keeps its own lock end, which is why no source may end later than it. Input parameters: - `chain_id` (integer|string, required): With ve_token, from get_ve33_allocations (STONX: 4663), not the wallet's chain - `destination_pool_key` (object): PoolKey {token0, token1, config} or {token0, token1, fee, tick_spacing, extension, stableswap_params?}, as read from the pool or vote - `destination_ve_id` (string, required): decimal integer - `resulting_vote` (object|null) - `sender` (string, required): address - `sources` (array, required) - `ve_token` (string, required): address Output parameters: - `execution_plan_reference` (object): artifact_reference; pass unchanged ### `prepare_ve33_withdraw` (~197 tokens) Prepare expired ve-token withdrawal Prepare fee-safe withdrawal of an expired ve-token stake, claiming the active pool first when voted and returning pending owner/stake validation. Ends the position: the stake leaves Ve33 and returns to the owner and the vote is cleared. Only an expired stake can be withdrawn — Ve33 reverts with StakeNotExpired at any earlier time, and there is no early exit or penalty path. Input parameters: - `chain_id` (integer|string, required): With ve_token, from get_ve33_allocations (STONX: 4663), not the wallet's chain - `current_pool_key` (object): PoolKey {token0, token1, config} or {token0, token1, fee, tick_spacing, extension, stableswap_params?}, as read from the pool or vote - `sender` (string, required): address - `ve_id` (string, required): decimal integer - `ve_token` (string, required): address Output parameters: - `execution_plan_reference` (object): artifact_reference; pass unchanged ### `get_liquidity_opportunities` (~236 tokens) Find Ekubo liquidity opportunities Return the interface's boosted-fee, incentive and projected ve(3,3)-emission opportunities ranked by APR, with actionable pools or pool-discovery handoffs, freshness and risk context. Call this before asking the user to choose a pair. APR is an annualized snapshot, not guaranteed yield: show its components, denominator, freshness, and range and impermanent-loss risk. If ranking_complete=false, run local_read_requirement through the wallet, decode it locally, and call again with ve33_emission_state. Input parameters: - `chain_id` (integer|string): Omit for every chain - `limit` (integer) - `min_apr` (number): APR ratio floor; 1.0 = 100% - `token` (string): Token in the pair (EVM or Starknet) (hex) - `types` (array): Defaults to all - `ve33_emission_state` (object): {current_timestamp, current_emission_rate, total_remaining_emissions}: decimal strings decoded locally from getEmissionState (rate is Q32) via local_read_requirement; omit on the first call Output parameters: - `local_read_requirement` (object|null) ### `prepare_pool_initialization` (~131 tokens) Prepare standalone pool initialization Prepare one permissionless maybeInitializePool transaction for a v3 PoolKey and initial tick; prepare_lp_position_deposit with pool_initialized=false does the same atomically with the mint. Input parameters: - `chain_id` (integer|string, required): EVM chain ID - `core_address` (string, required): v3 Core address - `initial_tick` (integer, required): The first initialization permanently sets the price - `pool_key` (object, required): Pool to initialize. PoolKey {token0, token1, config}: token addresses (zero = native), bytes32 config - `sender` (string, required): Submitting wallet (address) Output parameters: - `execution_plan_reference` (object): artifact_reference; pass unchanged ### `get_aave_v3_markets` (~167 tokens) List fixed Aave V3 markets Locally return six major Aave V3 core deployments and a bounded set of popular reserve, aToken, and variable-debt-token addresses from a pinned official Aave address-book snapshot. This tool makes no RPC, indexer, API, or other network request. For live rates, caps, pause state, liquidity, collateral settings, eMode categories, and account data, an agent may call Aave's public GraphQL API at https://api.v3.aave.com/graphql directly; this server is not in that data path. Intersect the API result with this fixed list before calling a preparation tool. Input parameters: - `chain_id` (integer|string): Optional exact chain filter. Omit to return every fixed Aave V3 core market supported by the preparation tools. Output parameters: - `agent_market_data_discovery` (object) - `limitations` (object) - `markets` (array) - `network_access` (string) - `protocol` (string) - `source` (object) ### `prepare_aave_v3_supply` (~165 tokens) Prepare an Aave V3 supply Prepare a fixed-market Aave V3 Pool supply with an exact ERC-20 approval, supply calldata, and allowance cleanup as one atomic wallet plan. No live balance, allowance, reserve, cap, pause, or rate data is queried. Input parameters: - `amount` (string, required): Positive underlying-token amount in base units (positive decimal integer) - `asset` (string, required): Exact underlying ERC-20 address from the selected market's fixed major-reserve list - `chain_id` (integer|string, required): Chain of a fixed Aave V3 core market returned by get_aave_v3_markets - `on_behalf_of` (string): aToken recipient; defaults to sender (address) - `sender` (string, required): Wallet that will execute the Aave action (address) Output parameters: - `execution_plan_reference` (object): artifact_reference; pass unchanged ### `prepare_aave_v3_withdraw` (~170 tokens) Prepare an Aave V3 withdrawal Prepare a direct Aave V3 Pool withdrawal for a supported fixed reserve. Pass uint256 maximum as amount to request the available aToken balance. The wallet establishes balance, health-factor, collateral, and liquidity validity by exact simulation. Input parameters: - `amount` (string, required): Positive underlying-token amount in base units; uint256 maximum requests all available balance (positive decimal integer) - `asset` (string, required): Exact underlying ERC-20 address from the selected market's fixed major-reserve list - `chain_id` (integer|string, required): Chain of a fixed Aave V3 core market returned by get_aave_v3_markets - `recipient` (string): Underlying-token recipient; defaults to sender (address) - `sender` (string, required): Wallet that will execute the Aave action (address) Output parameters: - `execution_plan_reference` (object): artifact_reference; pass unchanged ### `prepare_aave_v3_borrow` (~172 tokens) Prepare an Aave V3 variable borrow Prepare a direct Aave V3 variable-rate borrow from a supported fixed reserve, including optional on-behalf-of credit delegation. This server does not query collateral, delegation, health factor, caps, or available liquidity. Input parameters: - `amount` (string, required): Positive borrow amount in base units (positive decimal integer) - `asset` (string, required): Exact underlying ERC-20 address from the selected market's fixed major-reserve list - `chain_id` (integer|string, required): Chain of a fixed Aave V3 core market returned by get_aave_v3_markets - `on_behalf_of` (string): Debt owner; defaults to sender. A different owner must already have delegated variable debt to sender. (address) - `sender` (string, required): Wallet that will execute the Aave action (address) Output parameters: - `execution_plan_reference` (object): artifact_reference; pass unchanged ### `prepare_aave_v3_repay` (~195 tokens) Prepare an Aave V3 variable-debt repayment Prepare variable-debt repayment with underlying tokens or sender-owned aTokens. Underlying repayment carries an exact ERC-20 approval and cleanup in one atomic plan; uint256 maximum requests all available debt. Input parameters: - `amount` (string, required): Positive repayment amount in base units; uint256 maximum requests all available variable debt (positive decimal integer) - `asset` (string, required): Exact underlying ERC-20 address from the selected market's fixed major-reserve list - `chain_id` (integer|string, required): Chain of a fixed Aave V3 core market returned by get_aave_v3_markets - `funding_source` (string): Use underlying ERC-20 with a temporary exact Pool approval, or burn sender-owned aTokens with repayWithATokens - `on_behalf_of` (string): Debt owner; defaults to sender (address) - `sender` (string, required): Wallet that will execute the Aave action (address) Output parameters: - `execution_plan_reference` (object): artifact_reference; pass unchanged ### `prepare_aave_v3_collateral` (~137 tokens) Prepare an Aave V3 collateral toggle Prepare setUserUseReserveAsCollateral for a supported fixed reserve. Disabling collateral can reduce health factor or revert when open debt needs it, so exact wallet simulation is mandatory. Input parameters: - `asset` (string, required): Exact underlying ERC-20 address from the selected market's fixed major-reserve list - `chain_id` (integer|string, required): Chain of a fixed Aave V3 core market returned by get_aave_v3_markets - `sender` (string, required): Wallet that will execute the Aave action (address) - `use_as_collateral` (boolean, required): True enables this supplied reserve as collateral; false disables it Output parameters: - `execution_plan_reference` (object): artifact_reference; pass unchanged ### `prepare_aave_v3_emode` (~146 tokens) Prepare an Aave V3 eMode change Prepare setUserEMode with a caller-supplied current uint8 category ID; zero disables eMode. Discover live category configuration through Aave's public GraphQL API directly, because this server makes no data or RPC request. Input parameters: - `category_id` (integer, required): Current onchain Aave eMode category; zero disables eMode. Obtain nonzero category IDs from Aave's public GraphQL API, because this server does not query them. - `chain_id` (integer|string, required): Chain of a fixed Aave V3 core market returned by get_aave_v3_markets - `sender` (string, required): Wallet whose eMode selection will change (address) Output parameters: - `execution_plan_reference` (object): artifact_reference; pass unchanged ### `get_morpho_vaults` (~109 tokens) List fixed Morpho Vault V2 deployments Locally return a bounded, pinned catalog of listed Morpho Vault V2 deployments plus official direct-discovery guidance. This tool makes no API, RPC, indexer, or other network request. The agent must query Morpho's public GraphQL API and current onchain state directly, then intersect the result with the fixed chain, vault, and asset addresses before preparation. Input parameters: - `chain_id` (integer|string): Optional exact chain filter for the fixed Morpho Vault V2 catalog Output parameters: - `agent_market_data_discovery` (object) - `limitations` (object) - `network_access` (string) - `protocol` (string) - `source` (object) - `vaults` (array) ### `prepare_morpho_vault_deposit` (~272 tokens) Prepare a guarded Morpho vault deposit Prepare an exact-approval Morpho Vault V2 deposit through the official SDK's VaultBundlesV1 route. The caller supplies a fresh RAY-scaled max share price, which is enforced onchain against ERC-4626 share-price inflation; shares are minted to the sender and the server performs no data fetch. Input parameters: - `amount` (string, required): Positive underlying-asset amount in base units (positive decimal integer) - `chain_id` (integer|string, required): Chain returned by get_morpho_vaults - `deadline` (string): Unix timestamp after which VaultBundlesV1 rejects the deposit; defaults to two hours after preparation. One already past makes the plan a guaranteed revert. (positive decimal integer) - `max_share_price_ray` (string, required): Maximum acceptable vault share price in RAY (1e27), derived by the agent from fresh Morpho/onchain vault state plus the user's slippage tolerance (positive decimal integer) - `recipient` (string): Vault-share recipient; must equal sender if supplied, because VaultBundlesV1 mints shares only to the transaction sender (address) - `sender` (string, required): Wallet that will execute the Morpho action (address) - `vault` (string, required): Exact Morpho Vault V2 address returned by get_morpho_vaults Output parameters: - `execution_plan_reference` (object): artifact_reference; pass unchanged ### `prepare_morpho_vault_withdraw` (~170 tokens) Prepare a Morpho vault withdrawal Prepare a direct Morpho Vault V2 withdrawal for an exact underlying-asset amount from a fixed vault. Current shares, liquidity, permissions, and vault state are established by direct agent discovery and exact wallet simulation. Input parameters: - `amount` (string, required): Exact underlying-asset amount to withdraw in base units (positive decimal integer) - `chain_id` (integer|string, required): Chain returned by get_morpho_vaults - `owner` (string): Vault-share owner; defaults to sender (address) - `recipient` (string): Underlying-asset recipient; defaults to sender (address) - `sender` (string, required): Wallet that will execute the Morpho action (address) - `vault` (string, required): Exact Morpho Vault V2 address returned by get_morpho_vaults Output parameters: - `execution_plan_reference` (object): artifact_reference; pass unchanged ### `prepare_morpho_vault_redeem` (~164 tokens) Prepare a Morpho vault redemption Prepare a direct Morpho Vault V2 redemption for an exact share amount. Prefer redeem for full exits so the user's complete fresh share balance can be bound without asset/share rounding dust. Input parameters: - `chain_id` (integer|string, required): Chain returned by get_morpho_vaults - `owner` (string): Vault-share owner; defaults to sender (address) - `recipient` (string): Underlying-asset recipient; defaults to sender (address) - `sender` (string, required): Wallet that will execute the Morpho action (address) - `shares` (string, required): Exact vault-share amount to redeem in base units (positive decimal integer) - `vault` (string, required): Exact Morpho Vault V2 address returned by get_morpho_vaults Output parameters: - `execution_plan_reference` (object): artifact_reference; pass unchanged ### `get_sky_savings_deployment` (~52 tokens) Get the fixed Sky savings deployment Locally return the canonical Ethereum USDS and sUSDS addresses and direct wallet-read guidance. This server does not proxy Sky, an RPC, an indexer, or any third-party API. Output parameters: - `agent_market_data_discovery` (object) - `deployment` (object) - `limitations` (object) - `network_access` (string) - `protocol` (string) - `source` (object) ### `prepare_sky_savings_deposit` (~130 tokens) Prepare a Sky savings deposit Prepare an exact USDS approval, ERC-4626 sUSDS deposit, and allowance cleanup as one atomic wallet plan. The direct vault interface has no minimum-shares or deadline field, so a fresh preview and exact wallet simulation are mandatory. Input parameters: - `amount` (string, required): Exact USDS deposit amount in base units (positive decimal integer) - `chain_id` (integer|string, required): Must be Ethereum chain 1 - `receiver` (string): sUSDS recipient; defaults to sender (address) - `sender` (string, required): Wallet that will execute the Sky savings action (address) Output parameters: - `execution_plan_reference` (object): artifact_reference; pass unchanged ### `prepare_sky_savings_withdraw` (~135 tokens) Prepare a Sky savings withdrawal Prepare a direct sUSDS ERC-4626 withdrawal for an exact USDS amount. The server does not query current exchange rate, capacity, balance, allowance, or preview state. Input parameters: - `amount` (string, required): Exact USDS amount to withdraw in base units (positive decimal integer) - `chain_id` (integer|string, required): Must be Ethereum chain 1 - `owner` (string): sUSDS owner; defaults to sender (address) - `receiver` (string): USDS recipient; defaults to sender (address) - `sender` (string, required): Wallet that will execute the Sky savings action (address) Output parameters: - `execution_plan_reference` (object): artifact_reference; pass unchanged ### `prepare_sky_savings_redeem` (~136 tokens) Prepare a Sky savings redemption Prepare a direct sUSDS ERC-4626 redemption for an exact share amount. Use a fresh wallet/RPC balance and preview, then require exact wallet simulation before authorization. Input parameters: - `chain_id` (integer|string, required): Must be Ethereum chain 1 - `owner` (string): sUSDS owner; defaults to sender (address) - `receiver` (string): USDS recipient; defaults to sender (address) - `sender` (string, required): Wallet that will execute the Sky savings action (address) - `shares` (string, required): Exact sUSDS share amount to redeem in base units (positive decimal integer) Output parameters: - `execution_plan_reference` (object): artifact_reference; pass unchanged ### `get_merkl_deployment` (~75 tokens) Get the verified Merkl Distributor deployment Locally return the Merkl Distributor address, the chains it is verified on, and how Merkl's reward fields behave; preparation is limited to those chains. No Merkl API, RPC, or indexer request. Input parameters: - `chain_id` (integer|string): Optional chain to check against the verified Merkl Distributor catalog Output parameters: - `agent_market_data_discovery` (object) - `deployment` (object) - `limitations` (object) - `network_access` (string) - `protocol` (string) - `source` (object) ### `prepare_merkl_claim` (~153 tokens) Prepare a Merkl reward claim Prepare one Distributor claim for every Merkl reward token the sender holds on a chain, from amounts and proofs fetched from https://api.merkl.xyz/v4/users/{address}/rewards/summary. The proofs are folded into their Merkle root here, and the read bundle checks it against the root the chain enforces, so Merkl's API need not be trusted. Distinct from prepare_rewards_claim, which claims Ekubo's own incentive drops. Input parameters: - `chain_id` (integer|string, required): From the Merkl rewards summary - `rewards` (array, required): One entry per reward token on this chain, all in one claim - `sender` (string, required): Claiming wallet; the leaf's user address Output parameters: - `execution_plan_reference` (object): artifact_reference; pass unchanged ### `get_aerodrome_deployment` (~107 tokens) Get the verified Aerodrome Base deployment Locally return Aerodrome's Base contracts (AERO, veAERO, Voter, Router, v2 factory, RewardsDistributor, Slipstream, Sugar lenses), derived on chain from the Voter, plus the protocol behaviour an agent must respect. No API or RPC request. Aerodrome is Base-only; Velodrome is not prepared here. Input parameters: - `chain_id` (integer|string): Optional chain to check against Aerodrome's Base-only deployment Output parameters: - `agent_market_data_discovery` (object) - `deployment` (object) - `limitations` (object) - `network_access` (string) - `protocol` (string) - `source` (object) ### `prepare_aerodrome_sugar_reads` (~199 tokens) Prepare an Aerodrome Sugar read bundle Build the eth_call bundle and decode plan for one Sugar dataset (pools, positions, veNFTs, epochs, rewards) for the wallet to run against the user's RPC; Sugar has no API. The pool, gauge, fee and bribe addresses and veNFT ids it returns are the inputs to the other prepare_aerodrome_* tools. Input parameters: - `account` (string): Required for positions and venfts_by_account (address) - `chain_id` (integer|string, required): Base (8453) only - `dataset` (string, required): Sugar dataset - `limit` (integer): Page size; at most 500 pools or 200 positions - `offset` (integer) - `pool` (string): Required for pool_epochs and venft_pool_rewards (address) - `venft_id` (string): Required for venft_by_id, venft_rewards, and venft_pool_rewards (positive decimal integer) Output parameters: - `execution_plan_reference` (object): artifact_reference; pass unchanged ### `prepare_aerodrome_liquidity_deposit` (~260 tokens) Prepare an Aerodrome v2 liquidity deposit Prepare a v2 addLiquidity through Aerodrome's Router with exact approvals and allowance cleanup. The read bundle quotes the actual split and resolves the pool, so a pair with no pool is caught before a deposit sets its price. LP tokens earn no AERO until staked with prepare_aerodrome_gauge_deposit. Input parameters: - `amount_a_desired` (string, required): Maximum token_a base units (positive decimal integer) - `amount_a_min` (string, required): Slippage bound: minimum token_a base units consumed (positive decimal integer) - `amount_b_desired` (string, required): Maximum token_b base units (positive decimal integer) - `amount_b_min` (string, required): Minimum token_b base units consumed (positive decimal integer) - `chain_id` (integer|string, required): Base (8453) only - `deadline` (string, required): Near-term unix timestamp; a past one makes the plan revert (positive decimal integer) - `recipient` (string): Defaults to sender (address) - `sender` (string, required): address - `stable` (boolean, required): Stable (true) or volatile pool; with the pair it identifies the pool - `token_a` (string, required): address - `token_b` (string, required): address Output parameters: - `execution_plan_reference` (object): artifact_reference; pass unchanged ### `prepare_aerodrome_liquidity_withdraw` (~297 tokens) Prepare an Aerodrome v2 liquidity withdrawal Prepare a v2 removeLiquidity that burns LP tokens back into the underlying pair, with the LP-token approval the router needs and an allowance cleanup after. Phased, because the token being approved is the pool and this server resolves Aerodrome addresses by reading them: call it without lp_token to get the pool read back, then again with the resolved address for the complete atomic plan. An LP balance short of the requested liquidity usually means the rest is staked in the gauge and needs unstaking first. Input parameters: - `amount_a_min` (string, required): Minimum token_a base units to receive (positive decimal integer) - `amount_b_min` (string, required): Minimum token_b base units to receive (positive decimal integer) - `chain_id` (integer|string, required): Base (8453) only - `deadline` (string, required): Near-term unix timestamp; a past one makes the plan revert (positive decimal integer) - `liquidity` (string, required): Exact LP token amount to burn in base units (positive decimal integer) - `lp_token` (string): Pool address from this tool's first-phase read; omit to get that read, supply it for the full plan - `recipient` (string): Defaults to sender (address) - `sender` (string, required): address - `stable` (boolean, required): Stable (true) or volatile pool - `token_a` (string, required): address - `token_b` (string, required): address Output parameters: - `execution_plan_reference` (object): artifact_reference; pass unchanged ### `prepare_aerodrome_gauge_deposit` (~231 tokens) Prepare an Aerodrome gauge stake Stake v2 LP tokens into a pool's gauge to earn AERO emissions, with the LP-token approval the gauge needs and an allowance cleanup after. Phased, because which token the gauge pulls is its own stakingToken: call it without lp_token to get that read back, then again with the resolved address for the complete atomic plan. Staking redirects that position's trading fees to the pool's voters, so it trades fee income for emissions rather than adding to it. A dead gauge accepts the stake and pays nothing, so check gauge_alive. Size amount from the live LP balance, not from an earlier deposit simulation. Input parameters: - `amount` (string, required): Exact LP token amount to stake in base units (positive decimal integer) - `chain_id` (integer|string, required): Base (8453) only - `gauge` (string, required): Gauge from a Sugar pools read (address) - `lp_token` (string): Gauge stakingToken from this tool's first-phase read; omit to get that read, supply it for the full plan (address) - `sender` (string, required): address Output parameters: - `execution_plan_reference` (object): artifact_reference; pass unchanged ### `prepare_aerodrome_gauge_withdraw` (~119 tokens) Prepare an Aerodrome gauge unstake Unstake v2 LP tokens from a gauge. This returns the LP token, not the underlying pair, and it does not claim AERO: the read bundle reports what is still earned so it is not silently left behind. Input parameters: - `amount` (string, required): Exact LP token amount to unstake in base units (positive decimal integer) - `chain_id` (integer|string, required): Base (8453) only - `gauge` (string, required): Gauge from a Sugar pools read (address) - `sender` (string, required): address Output parameters: - `execution_plan_reference` (object): artifact_reference; pass unchanged ### `prepare_aerodrome_gauge_claim` (~132 tokens) Prepare an Aerodrome emissions claim Claim accrued AERO from a gauge. getReward credits its account argument rather than the sender, so a claim can pay a different address than the one paying gas; the plan states which. A claim with nothing earned succeeds and transfers nothing. Input parameters: - `account` (string): Account whose emissions are claimed; defaults to sender. getReward credits this address, so a non-sender value pays someone else. - `chain_id` (integer|string, required): Base (8453) only - `gauge` (string, required): Gauge from a Sugar pools read (address) - `sender` (string, required): address Output parameters: - `execution_plan_reference` (object): artifact_reference; pass unchanged ### `prepare_aerodrome_lock` (~237 tokens) Prepare a veAERO lock action Build one veAERO escrow action: create a lock, add AERO to one, extend it, switch permanent locking on or off, or withdraw an expired one. Durations are measured from now and floored to a week boundary, so anything under a week is refused rather than signed. The read bundle returns ownership and the lock's (amount, end, isPermanent) so an impossible action — withdrawing an unexpired or permanent lock, extending past nothing — is caught before signing. Input parameters: - `action` (string, required): Which veAERO lock action to build - `amount` (string): AERO amount in base units; required for create and increase_amount (positive decimal integer) - `chain_id` (integer|string, required): Base (8453) only - `lock_duration` (string): Lock length in seconds measured from now, required for create and extend. The escrow floors it to a week boundary and caps it at four years. (positive decimal integer) - `sender` (string, required): address - `venft_id` (string): veNFT token id; required for every action but create (positive decimal integer) Output parameters: - `execution_plan_reference` (object): artifact_reference; pass unchanged ### `prepare_aerodrome_vote` (~196 tokens) Prepare a veAERO vote or reset Cast one veNFT's gauge vote, or reset it. Weights are relative shares of voting power, not amounts, and the allocation replaces any previous vote entirely — a pool left out is voted zero. A veNFT may vote once per weekly epoch and reverts on a second attempt, so the read bundle returns lastVoted along with each pool's gauge and liveness. Voting also locks the NFT against withdrawal until it is reset. Input parameters: - `chain_id` (integer|string, required): Base (8453) only - `pools` (array): The complete allocation. It replaces any previous vote, so a pool left out is voted zero rather than left alone. - `reset` (boolean): Clear this NFT's votes instead of casting new ones; required before withdrawing a voted NFT - `sender` (string, required): address - `venft_id` (string, required): veNFT token id casting the vote (positive decimal integer) Output parameters: - `execution_plan_reference` (object): artifact_reference; pass unchanged ### `prepare_aerodrome_incentive_claim` (~221 tokens) Prepare a veAERO reward claim Claim a veNFT's voting rewards — trading fees, bribes, or both — and optionally the RewardsDistributor rebase, as one plan. The fee and bribe contract addresses are required inputs because they are per-pool contracts that only a Sugar rewards read returns; this server cannot derive them, and a wrong address claims nothing rather than failing loudly. Distinct from prepare_aerodrome_gauge_claim, which collects an LP's emissions rather than a voter's rewards. Input parameters: - `bribes` (array): Bribe contracts and their tokens, taken from a Sugar venft_rewards read - `chain_id` (integer|string, required): Base (8453) only - `claim_rebase` (boolean): Also claim the RewardsDistributor rebase, which compounds into the lock - `fees` (array): Fee contracts and their tokens, taken from a Sugar venft_rewards read - `sender` (string, required): address - `venft_id` (string, required): veNFT token id whose rewards are claimed (positive decimal integer) Output parameters: - `execution_plan_reference` (object): artifact_reference; pass unchanged ### `decode_uniswap_v4_position_info` (~56 tokens) Decode Uniswap V4 position info Decode the packed PositionInfo returned by wallet reads into signed tick bounds, subscriber flag and the truncated pool-ID prefix. This is local integer decoding, not a state query. Input parameters: - `info` (string, required): decimal integer Output parameters: - `has_subscriber` (boolean) - `instruction` (string) - `pool_id_prefix` (string) - `tick_lower` (integer) - `tick_upper` (integer) ### `quote_uniswap_liquidity` (~134 tokens) Calculate Uniswap concentrated liquidity amounts Calculate V3/V4 range liquidity, rounded mint/burn amounts and explicit token bounds from a current sqrt-price snapshot and raw token budgets, or an exact liquidity amount. Fees are excluded. Obtain current state using prepare_uniswap_reads. Input parameters: - `amount0` (string, required): decimal integer - `amount1` (string, required): decimal integer - `liquidity` (string): decimal integer - `slippage_bps` (integer) - `sqrt_price_x96` (string, required): decimal integer - `tick_lower` (integer, required) - `tick_spacing` (integer, required) - `tick_upper` (integer, required) Output parameters: - `amount0_max` (string) - `amount0_min` (string) - `amount1_max` (string) - `amount1_min` (string) - `input_snapshot` (object) - `instructions` (string) - `liquidity` (string) - `live_state_queried` (boolean) - `mint_amount0` (string) - `mint_amount1` (string) ### `get_uniswap_deployments` (~48 tokens) Get Uniswap deployments Canonical V2/V3/V4 contracts on Ethereum, Optimism, Base, Arbitrum, Unichain and Robinhood, including Permit2 and wrapped native addresses. Output parameters: - `deployments` (array) - `protocol` (string) - `source` (string) ### `discover_uniswap_pools` (~103 tokens) Discover Uniswap pools Fetch indexed V2, V3 or V4 pools ranked by TVL from Uniswap's interface API. Filter by chain and token; paginate using the last pool's TVL as tvl_cursor. Returns token symbols and decimals, liquidity and daily volume. Input parameters: - `chain_id` (string, required) - `first` (integer) - `token_address` (string): address - `tvl_cursor` (number) - `version` (string, required) Output parameters: - `data` - `errors` (array) - `fetched_at` (string) - `indexed_data` (boolean) - `partial` (boolean) - `source` (string) ### `get_uniswap_pool` (~75 tokens) Get a Uniswap pool Fetch indexed pool details, currencies, fee, TVL, volume and supplies. V4 takes a bytes32 pool ID; V2/V3 take an address. Use prepare_uniswap_reads for current chain state. Input parameters: - `chain_id` (string, required) - `pool` (string, required) - `version` (string, required) Output parameters: - `data` - `errors` (array) - `fetched_at` (string) - `indexed_data` (boolean) - `partial` (boolean) - `source` (string) ### `get_uniswap_pool_ticks` (~96 tokens) Get Uniswap liquidity depth data Fetch paginated initialized ticks and exact liquidityNet/liquidityGross strings for V3/V4 liquidity depth charts. first/skip bound each request; combine with current pool liquidity and tick from prepare_uniswap_reads. Indexer data can lag. Input parameters: - `chain_id` (string, required) - `first` (integer) - `pool` (string, required) - `skip` (integer) - `version` (string, required) Output parameters: - `data` - `errors` (array) - `fetched_at` (string) - `indexed_data` (boolean) - `partial` (boolean) - `source` (string) ### `get_uniswap_charts` (~81 tokens) Get Uniswap pool charts Fetch timestamped token0/token1 prices and USD volume history over the requested duration from the same GraphQL fields as the open source Uniswap interface. Empty series means no indexed data, never zero volume. Input parameters: - `chain_id` (string, required) - `duration` (string) - `pool` (string, required) - `version` (string, required) Output parameters: - `data` - `errors` (array) - `fetched_at` (string) - `indexed_data` (boolean) - `partial` (boolean) - `source` (string) ### `prepare_uniswap_reads` (~149 tokens) Prepare Uniswap pool and position reads Return exact wallet read bundles for pool state, reserves, positions and ownership. V3 supports bounded owner-index enumeration. V4 requires known token IDs. Verify returned tokens, fee, factory/pool key, tick spacing and owner before preparing liquidity operations. Input parameters: - `chain_id` (string, required) - `fee` (integer) - `hooks` (string): address - `owner` (string): address - `owner_indices` (array) - `pool_address` (string): address - `tick_spacing` (integer) - `token0` (string, required): address - `token1` (string, required): address - `token_ids` (array) - `version` (string, required) Output parameters: - `read_calls_reference` (object): artifact_reference; pass unchanged ### `prepare_uniswap_v2_add_liquidity` (~158 tokens) Prepare Uniswap V2 liquidity deposit Add liquidity or create a V2 pair with exact token approvals and cleanup. Amounts are raw units; sorted token0/token1 and explicit minimum outputs are required. use_native pays ETH for the wrapped-native side. Execute atomically through the wallet. Input parameters: - `amount0` (string, required): decimal integer - `amount0_min` (string, required): decimal integer - `amount1` (string, required): decimal integer - `amount1_min` (string, required): decimal integer - `chain_id` (string, required) - `deadline` (string, required): decimal integer - `sender` (string, required): address - `token0` (string, required): address - `token1` (string, required): address - `use_native` (boolean) Output parameters: - `execution_plan_reference` (object): artifact_reference; pass unchanged ### `prepare_uniswap_v2_remove_liquidity` (~151 tokens) Prepare Uniswap V2 liquidity withdrawal Burn an exact LP amount through the canonical V2 router; realize accrued fees with principal. Raw minima protect withdrawal proceeds. LP token address is derived from the factory. Optional native unwrapping. V2 has no separate fee claim. Requires atomic LP approval and cleanup. Input parameters: - `amount0_min` (string, required): decimal integer - `amount1_min` (string, required): decimal integer - `chain_id` (string, required) - `deadline` (string, required): decimal integer - `liquidity` (string, required): decimal integer - `sender` (string, required): address - `token0` (string, required): address - `token1` (string, required): address - `unwrap_native` (boolean) Output parameters: - `execution_plan_reference` (object): artifact_reference; pass unchanged ### `prepare_uniswap_v3_add_liquidity` (~218 tokens) Prepare Uniswap V3 liquidity deposit Mint a ranged NFT or increase token_id with raw desired amounts and minima. First verify factory fee tick spacing and position tokens/range. Optional initialize_sqrt_price_x96 creates the pool; use_native pays ETH and refunds excess. Exact approvals and cleanup require an atomic wallet. Input parameters: - `amount0` (string, required): decimal integer - `amount0_min` (string, required): decimal integer - `amount1` (string, required): decimal integer - `amount1_min` (string, required): decimal integer - `chain_id` (string, required) - `deadline` (string, required): decimal integer - `fee` (integer, required) - `initialize_sqrt_price_x96` (string): decimal integer - `sender` (string, required): address - `tick_lower` (integer, required) - `tick_spacing` (integer, required) - `tick_upper` (integer, required) - `token0` (string, required): address - `token1` (string, required): address - `token_id` (string): decimal integer - `use_native` (boolean) Output parameters: - `execution_plan_reference` (object): artifact_reference; pass unchanged ### `prepare_uniswap_v3_remove_liquidity` (~150 tokens) Prepare Uniswap V3 liquidity withdrawal Decrease exact uint128 liquidity, collect principal and all accrued fees, and optionally burn a fully emptied NFT. Raw minima protect withdrawal proceeds. Optional unwrap_native requires verified position currencies. Input parameters: - `amount0_min` (string, required): decimal integer - `amount1_min` (string, required): decimal integer - `burn` (boolean) - `chain_id` (string, required) - `deadline` (string, required): decimal integer - `liquidity` (string, required): decimal integer - `sender` (string, required): address - `token0` (string, required): address - `token1` (string, required): address - `token_id` (string, required): decimal integer - `unwrap_native` (boolean) Output parameters: - `execution_plan_reference` (object): artifact_reference; pass unchanged ### `prepare_uniswap_v3_collect_fees` (~112 tokens) Prepare Uniswap V3 fee collection Collect all owed fees without removing liquidity, optionally unwrapping WETH. Verify NFT ownership and currencies first. V3 collect has no onchain deadline; regenerate and simulate before execution. Input parameters: - `chain_id` (string, required) - `deadline` (string, required): decimal integer - `sender` (string, required): address - `token0` (string, required): address - `token1` (string, required): address - `token_id` (string, required): decimal integer - `unwrap_native` (boolean) Output parameters: - `execution_plan_reference` (object): artifact_reference; pass unchanged ### `prepare_uniswap_v4_add_liquidity` (~242 tokens) Prepare Uniswap V4 liquidity deposit Mint or increase an exact liquidity amount using raw uint128 token maxima. Zero token0 means native ETH. Uses exact ERC20 and Permit2 approvals with cleanup, settles both signs of accrued-fee deltas on increase, and refunds native surplus. Verify NFT pool key/range and hook behavior; hook_data is forwarded unchanged. Optional pool initialization. Input parameters: - `amount0_max` (string, required): decimal integer - `amount1_max` (string, required): decimal integer - `chain_id` (string, required) - `deadline` (string, required): decimal integer - `fee` (integer, required) - `hook_data` (string): hex bytes - `hooks` (string): address - `initialize_sqrt_price_x96` (string): decimal integer - `liquidity` (string, required): decimal integer - `pool_id` (string, required): bytes32 hex - `sender` (string, required): address - `tick_lower` (integer, required) - `tick_spacing` (integer, required) - `tick_upper` (integer, required) - `token0` (string, required): address - `token1` (string, required): address - `token_id` (string): decimal integer Output parameters: - `execution_plan_reference` (object): artifact_reference; pass unchanged ### `prepare_uniswap_v4_remove_liquidity` (~197 tokens) Prepare Uniswap V4 liquidity withdrawal Remove liquidity and take principal plus fees to the sender. Optional burn:true requires liquidity:0 and withdraws the entire NFT with minima applied to the full position. Requires exact pool currencies and hook data; uint128 minima bound principal outputs. Input parameters: - `amount0_min` (string, required): decimal integer - `amount1_min` (string, required): decimal integer - `burn` (boolean) - `chain_id` (string, required) - `deadline` (string, required): decimal integer - `fee` (integer, required) - `hook_data` (string): hex bytes - `hooks` (string): address - `liquidity` (string, required): decimal integer - `pool_id` (string, required): bytes32 hex - `sender` (string, required): address - `tick_spacing` (integer, required) - `token0` (string, required): address - `token1` (string, required): address - `token_id` (string, required): decimal integer Output parameters: - `execution_plan_reference` (object): artifact_reference; pass unchanged ### `prepare_uniswap_v4_collect_fees` (~143 tokens) Prepare Uniswap V4 fee collection Poke a V4 position with zero liquidity decrease then take both currencies to the sender. Principal remains invested. Verify ownership, pool key and hook behavior first. Input parameters: - `chain_id` (string, required) - `deadline` (string, required): decimal integer - `fee` (integer, required) - `hook_data` (string): hex bytes - `hooks` (string): address - `pool_id` (string, required): bytes32 hex - `sender` (string, required): address - `tick_spacing` (integer, required) - `token0` (string, required): address - `token1` (string, required): address - `token_id` (string, required): decimal integer Output parameters: - `execution_plan_reference` (object): artifact_reference; pass unchanged ### `get_lido_deployment` (~50 tokens) Get the fixed Lido mainnet deployment Locally return canonical Ethereum stETH, wstETH, and WithdrawalQueueERC721 addresses plus direct wallet-read guidance. This server makes no Lido API, RPC, or indexer request. Output parameters: - `agent_market_data_discovery` (object) - `deployment` (object) - `limitations` (object) - `network_access` (string) - `protocol` (string) - `source` (object) ### `prepare_lido_stake` (~109 tokens) Prepare Lido ETH staking Prepare the canonical Lido submit call with exact native ETH value and an explicit or zero referral. The agent must read current staking pause and limit state directly; the wallet then simulates the exact transaction. Input parameters: - `amount` (string, required): Exact native ETH stake amount in wei (positive decimal integer) - `chain_id` (integer|string, required): Must be Ethereum chain 1 - `referral` (string): Optional Lido referral address; defaults to zero address - `sender` (string, required): address Output parameters: - `execution_plan_reference` (object): artifact_reference; pass unchanged ### `prepare_lido_wrap` (~75 tokens) Prepare stETH wrapping Prepare an exact stETH approval, wstETH wrap call, and allowance cleanup in one atomic wallet plan. Input parameters: - `amount` (string, required): Exact stETH amount to wrap in base units (positive decimal integer) - `chain_id` (integer|string, required): Must be Ethereum chain 1 - `sender` (string, required): address Output parameters: - `execution_plan_reference` (object): artifact_reference; pass unchanged ### `prepare_lido_unwrap` (~78 tokens) Prepare wstETH unwrapping Prepare a direct wstETH unwrap call for an exact share amount, returning rebasing stETH to the sender. Input parameters: - `amount` (string, required): Exact wstETH amount to unwrap in base units (positive decimal integer) - `chain_id` (integer|string, required): Must be Ethereum chain 1 - `sender` (string, required): address Output parameters: - `execution_plan_reference` (object): artifact_reference; pass unchanged ### `prepare_lido_withdrawal_request` (~138 tokens) Prepare a Lido withdrawal request Prepare one or more bounded stETH withdrawal requests with an exact queue approval and cleanup. This irreversible asynchronous action mints unstETH NFTs, stops rewards while queued, and can settle below 1:1 after extraordinary losses; wallet simulation and clear user review are required. Input parameters: - `amounts` (array, required): One to 64 stETH request amounts, each from 100 wei through 1000 stETH - `chain_id` (integer|string, required): Must be Ethereum chain 1 - `owner` (string): Recipient/owner of the unstETH request NFTs; defaults to sender (address) - `sender` (string, required): address Output parameters: - `execution_plan_reference` (object): artifact_reference; pass unchanged ### `prepare_lido_withdrawal_claim` (~97 tokens) Prepare a Lido withdrawal claim Prepare claimWithdrawal for one finalized, unclaimed unstETH request ID owned by the sender. The agent must verify ownership and finalization directly through the user's wallet/RPC before preparation. Input parameters: - `chain_id` (integer|string, required): Must be Ethereum chain 1 - `request_id` (string, required): Finalized, unclaimed unstETH NFT request ID owned by sender (positive decimal integer) - `sender` (string, required): address Output parameters: - `execution_plan_reference` (object): artifact_reference; pass unchanged ## Diagnostics Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/ekuboprotocol-ekubo/mcp#diagnostics ## Score history - 2026-11-05: 66 - 2026-11-04: 66 ## Common questions ### What is the Ekubo Protocol MCP server? Ekubo Protocol is an MCP server listed in the public MCP registry as io.github.EkuboProtocol/ekubo. Token and pool data, swap quotes, and unsigned transaction plans for Ekubo and other DeFi protocols. This page covers its hosted endpoint (https://mcp.ekubo.org/mcp). ### Is the Ekubo Protocol MCP server safe to use? Ekubo Protocol scores 66 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm. ### What tools does the Ekubo Protocol MCP server expose? Ekubo Protocol exposes 99 tools: list_tokens, export_tokens, get_token, get_tokens, get_quotes_with_plans, and 94 more. Their descriptions and schemas cost roughly 15,423 tokens of context every time the server is loaded. ### Does the Ekubo Protocol MCP server require authentication? No. We connected to Ekubo Protocol without credentials and it answered, so anything it exposes is reachable by anyone who knows the address. ### Is the Ekubo Protocol MCP server still maintained? Ekubo Protocol is still listed as active in the MCP registry. We last reached this channel on 5 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced. ## Links - Remote endpoint: https://mcp.ekubo.org/mcp - Repository: https://github.com/EkuboProtocol/ekubo-mcp-server - Website: https://docs.ekubo.org/products/mcp-server/ - Changelog RSS feed: https://verifymcp.io/servers/ekuboprotocol-ekubo/mcp.xml - Changelog JSON feed: https://verifymcp.io/servers/ekuboprotocol-ekubo/mcp.json - HTML version of this page: https://verifymcp.io/servers/ekuboprotocol-ekubo/mcp