{"data":{"name":"io.github.EkuboProtocol/ekubo","title":"Ekubo Protocol","description":"Token and pool data, swap quotes, and unsigned transaction plans for Ekubo and other DeFi protocols.","version":"0.54.0","websiteUrl":"https://docs.ekubo.org/products/mcp-server/","repositoryUrl":"https://github.com/EkuboProtocol/ekubo-mcp-server","remotes":[{"type":"streamable-http","url":"https://mcp.ekubo.org/mcp"}],"packages":[],"status":"active","isLatest":true,"publishedAt":"2026-11-04T16:38:12.078Z","updatedAt":"2026-11-04T16:38:12.078Z","source":"official-registry","verification":"official","confidence":100,"stars":null,"sources":[{"source":"official-registry","sourceId":"io.github.EkuboProtocol/ekubo","verification":"official","confidence":100,"stars":null,"updatedAt":"2026-11-04T16:38:12.078Z","title":"Ekubo Protocol","description":"Token and pool data, swap quotes, and unsigned transaction plans for Ekubo and other DeFi protocols.","websiteUrl":"https://docs.ekubo.org/products/mcp-server/","repositoryUrl":"https://github.com/EkuboProtocol/ekubo-mcp-server"}],"toolIndex":{"tools":[{"serverName":"io.github.EkuboProtocol/ekubo","endpointFingerprint":"6e5c3b3d403bf28ec8578cc2c19eb69f275057f7dc780e2e2f0cda5542f9fd1f","name":"decode_pool_config","title":"Decode an Ekubo pool config","description":"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.","inputSchema":{"type":"object","properties":{"config":{"type":"string","description":"bytes32 hex"}},"required":["config"]},"annotations":{"readOnlyHint":true,"openWorldHint":false},"definitionHash":"a56b546d7b207f8c083cb02a40eed6c41f5f58cb691647613414b0244ac12f82","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-17T08:46:23.638Z","metadataTrust":"untrusted"},{"serverName":"io.github.EkuboProtocol/ekubo","endpointFingerprint":"6e5c3b3d403bf28ec8578cc2c19eb69f275057f7dc780e2e2f0cda5542f9fd1f","name":"derive_pool_id","title":"Derive an Ekubo pool ID","description":"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.","inputSchema":{"type":"object","properties":{"pool_key":{"type":"object","properties":{"token0":{"type":"string","description":"address"},"token1":{"type":"string","description":"address"},"config":{"type":"string","description":"bytes32 hex"},"fee":{"description":"uint64 Q64 fee as a string, never a JSON number (decimal or 0x-hex integer)","type":"string"},"tick_spacing":{"type":["integer","string"],"minimum":1,"description":"decimal or 0x-hex integer"},"extension":{"type":"string","description":"address"},"stableswap_params":{"type":"object","properties":{"center_tick":{"type":"integer"},"amplification":{"type":"integer","minimum":0,"maximum":127}},"required":["center_tick","amplification"]}},"required":["token0","token1"]}},"required":["pool_key"]},"annotations":{"readOnlyHint":true,"openWorldHint":false},"definitionHash":"e476837fc28e94bad65457e433ed02c7a13f62ac1144490c118eef0dc788e4a7","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-17T08:46:23.638Z","metadataTrust":"untrusted"},{"serverName":"io.github.EkuboProtocol/ekubo","endpointFingerprint":"6e5c3b3d403bf28ec8578cc2c19eb69f275057f7dc780e2e2f0cda5542f9fd1f","name":"export_tokens","title":"Export Ekubo tokens for a wallet","description":"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.","inputSchema":{"type":"object","properties":{"chain_id":{"type":["integer","string"],"description":"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":{"description":"Defaults to 1,000, what a wallet accepts in one import; a larger export is refused whole, not truncated","type":"integer","minimum":1,"maximum":10000}}},"annotations":{"readOnlyHint":true},"definitionHash":"2aa89025594871276a844236d7de5a75578b812c9aefaa84b6bf9f4f0e4459a6","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-17T08:46:23.638Z","metadataTrust":"untrusted"},{"serverName":"io.github.EkuboProtocol/ekubo","endpointFingerprint":"6e5c3b3d403bf28ec8578cc2c19eb69f275057f7dc780e2e2f0cda5542f9fd1f","name":"get_liquidity_opportunities","title":"Find Ekubo liquidity opportunities","description":"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.","inputSchema":{"type":"object","properties":{"chain_id":{"type":["integer","string"],"description":"Omit for every chain"},"types":{"default":["boosted_fees","incentive","ve33_emissions"],"description":"Defaults to all","minItems":1,"type":"array","items":{"type":"string","enum":["boosted_fees","incentive","ve33_emissions"]}},"token":{"description":"Token in the pair (EVM or Starknet) (hex)","type":"string"},"min_apr":{"description":"APR ratio floor; 1.0 = 100%","type":"number","minimum":0},"limit":{"default":25,"type":"integer","minimum":1,"maximum":100},"ve33_emission_state":{"type":"object","description":"{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"}}},"annotations":{"readOnlyHint":true},"definitionHash":"69d13f2bfb3f43c945f0ca7e39c8686ff4fb7ab988a0c096135e9ab79d752e71","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-17T08:46:23.638Z","metadataTrust":"untrusted"},{"serverName":"io.github.EkuboProtocol/ekubo","endpointFingerprint":"6e5c3b3d403bf28ec8578cc2c19eb69f275057f7dc780e2e2f0cda5542f9fd1f","name":"get_pool","title":"Get an Ekubo pool","description":"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.","inputSchema":{"type":"object","properties":{"chain_id":{"type":["integer","string"],"description":"EVM chain ID"},"core_address":{"type":"string","description":"address"},"pool_id":{"type":"string","description":"Pool ID (decimal or 0x-hex integer)"}},"required":["chain_id","core_address","pool_id"]},"annotations":{"readOnlyHint":true},"definitionHash":"843023797a13010852f7ae2eaab98a643196e104b7e72b9ab928fc99ab5f4f40","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-17T08:46:23.638Z","metadataTrust":"untrusted"},{"serverName":"io.github.EkuboProtocol/ekubo","endpointFingerprint":"6e5c3b3d403bf28ec8578cc2c19eb69f275057f7dc780e2e2f0cda5542f9fd1f","name":"get_pool_liquidity","title":"Get Ekubo pool liquidity depth","description":"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.","inputSchema":{"type":"object","properties":{"chain_id":{"type":["integer","string"],"description":"EVM chain ID"},"core_address":{"type":"string","description":"address"},"pool_id":{"type":"string","description":"Pool ID (decimal or 0x-hex integer)"}},"required":["chain_id","core_address","pool_id"]},"annotations":{"readOnlyHint":true},"definitionHash":"88b092bc6ff8c4b825e096f6d50ccfab018d50e59ce9d9be567c9168beecb578","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-17T08:46:23.638Z","metadataTrust":"untrusted"},{"serverName":"io.github.EkuboProtocol/ekubo","endpointFingerprint":"6e5c3b3d403bf28ec8578cc2c19eb69f275057f7dc780e2e2f0cda5542f9fd1f","name":"get_position","title":"Get complete Ekubo position details","description":"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.","inputSchema":{"type":"object","properties":{"owner":{"type":"string","description":"Current owner (address)"},"chain_id":{"type":["integer","string"],"description":"EVM chain ID"},"positions_address":{"type":"string","description":"Ekubo Positions or Ve33Positions manager (address)"},"token_id":{"type":"string","description":"Position NFT ID (decimal or 0x-hex integer)"}},"required":["owner","chain_id","positions_address","token_id"]},"annotations":{"readOnlyHint":true},"definitionHash":"5385b64dd59a1982100af48fcabcfb9c4fab39b4dbb051fbbe5c802552861dff","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-17T08:46:23.638Z","metadataTrust":"untrusted"},{"serverName":"io.github.EkuboProtocol/ekubo","endpointFingerprint":"6e5c3b3d403bf28ec8578cc2c19eb69f275057f7dc780e2e2f0cda5542f9fd1f","name":"get_position_pool_candidates","title":"Find pools for an LP position","description":"List indexed pools eligible for new deposits (excluding retired Ethereum MEVCapture v2.1) 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.","inputSchema":{"type":"object","properties":{"chain_id":{"type":["integer","string"],"description":"EVM chain ID"},"token_a":{"type":"string","description":"Either order (address)"},"token_b":{"type":"string","description":"address"},"min_tvl_usd":{"default":0,"description":"TVL floor; default 0 keeps tiny pools visible","type":"number","minimum":0},"core_address":{"type":"string","description":"address"},"extension":{"type":"string","description":"address"},"pool_type":{"type":"string","enum":["concentrated","stableswap"]}},"required":["chain_id","token_a","token_b"]},"annotations":{"readOnlyHint":true},"definitionHash":"f1d680c8477878e6ccd774ccb11764d6bffe0f21c6c0d5c81b44f37c1f82782d","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-17T08:46:23.638Z","metadataTrust":"untrusted"},{"serverName":"io.github.EkuboProtocol/ekubo","endpointFingerprint":"6e5c3b3d403bf28ec8578cc2c19eb69f275057f7dc780e2e2f0cda5542f9fd1f","name":"get_positions_by_owner","title":"Get Ekubo positions by owner","description":"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.","inputSchema":{"type":"object","properties":{"owner":{"type":"string","description":"address"},"chain_id":{"type":["integer","string"],"description":"EVM chain ID"},"state":{"type":"string","enum":["opened","closed"]},"page_size":{"default":50,"type":"integer","minimum":1,"maximum":200},"page":{"default":1,"type":"integer","minimum":1}},"required":["owner"]},"annotations":{"readOnlyHint":true},"definitionHash":"6922ef219aa0956ddc08b607cc6e159de1c8fa7425ae095be493d6921b1459f9","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-17T08:46:23.638Z","metadataTrust":"untrusted"},{"serverName":"io.github.EkuboProtocol/ekubo","endpointFingerprint":"6e5c3b3d403bf28ec8578cc2c19eb69f275057f7dc780e2e2f0cda5542f9fd1f","name":"get_quotes_with_plans","title":"Get swap or bridge quotes with execution plans","description":"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.","inputSchema":{"type":"object","properties":{"chain_id":{"type":["integer","string"],"description":"EVM chain ID"},"destination_chain_id":{"type":["integer","string"],"description":"Destination chain; defaults to chain_id for a same-chain swap"},"token_in":{"type":"string","pattern":"^(?:0x[0-9a-fA-F]{1,40}|eip155:[0-9]+:0x[0-9a-fA-F]{1,40})$","description":"Raw EVM address or CAIP-10 eip155:<chain_id>:<address>; all-zeroes denotes the native token"},"token_out":{"type":"string","pattern":"^(?:0x[0-9a-fA-F]{1,40}|eip155:[0-9]+:0x[0-9a-fA-F]{1,40})$","description":"Raw EVM address or CAIP-10 eip155:<chain_id>:<address>; all-zeroes denotes the native token"},"quote_type":{"type":"string","enum":["exact_input","exact_output"]},"amount":{"type":"string","description":"Base units (positive decimal integer)"},"max_output_loss":{"description":"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 ppm, verify final minBuyAmount; positive budgets below 1 ppm fail, never become zero. Others unsupported. Convert gas value to output base units rounding down; never widen to 1 bps.","type":"string","pattern":"^(0|[1-9][0-9]{0,77})$"},"sender":{"description":"Transaction sender; pass with exactly one of slippage_bps or max_output_loss for plans (address)","type":"string"},"recipient":{"description":"Defaults to sender (address)","type":"string"},"slippage_bps":{"description":"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 0 or 1 bps. No generic 50 bps default. After slippage failure re-quote, never widen or retry reverted bytes.","type":"integer","minimum":0,"maximum":10000},"swap_deadline_minutes":{"description":"Ekubo router route deadline; default 30","type":"integer","minimum":1,"maximum":30},"include_raw_quotes":{"description":"Echo raw provider responses; only to diagnose a provider","type":"boolean"}},"required":["chain_id","token_in","token_out","quote_type","amount"]},"annotations":{"readOnlyHint":true},"definitionHash":"758d54220c97ae56e90fe697201b2232eb70b2fe2730c842de043b2203995d1d","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-17T08:46:23.638Z","metadataTrust":"untrusted"},{"serverName":"io.github.EkuboProtocol/ekubo","endpointFingerprint":"6e5c3b3d403bf28ec8578cc2c19eb69f275057f7dc780e2e2f0cda5542f9fd1f","name":"get_rewards_claims_by_owner","title":"Get incentive rewards claims by owner","description":"Fetch canonical reward-claim records and supply the exact per-chain isClaimed/isAvailable eth_call list used by the interface before preparing claim transactions.","inputSchema":{"type":"object","properties":{"owner":{"type":"string","description":"address"}},"required":["owner"]},"annotations":{"readOnlyHint":true},"definitionHash":"1e2697300c837c33eb39ca0a3c1819dee2e9b9cd2563f88d8b5ae5c61aded5d1","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-17T08:46:23.638Z","metadataTrust":"untrusted"},{"serverName":"io.github.EkuboProtocol/ekubo","endpointFingerprint":"6e5c3b3d403bf28ec8578cc2c19eb69f275057f7dc780e2e2f0cda5542f9fd1f","name":"get_stonx_allocation_recommendation","title":"Get suggested STONX allocations","description":"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.","inputSchema":{"type":"object","properties":{"voter":{"description":"With ve33_emission_state, makes targets voter-optimal","type":"object","properties":{"vote_weight":{"type":"string","pattern":"^(?:0|[1-9][0-9]{0,77})$","description":"Total applied vote weight from get_ve33_allocations"},"pools":{"type":"array","items":{"type":"object","properties":{"pool_key_id":{"type":"string","description":"Ve33 pool_key_id (decimal integer)"},"lp_share":{"type":"number","minimum":0,"maximum":1,"description":"Voter's share of the pool's emission-earning liquidity"},"current_vote_weight":{"description":"Defaults to 0","type":"string","pattern":"^(?:0|[1-9][0-9]{0,77})$"}},"required":["pool_key_id","lp_share"]}}},"required":["vote_weight","pools"]},"ve33_emission_state":{"type":"object","description":"{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"},"prune_low_efficiency":{"default":false,"description":"Withhold prune candidates and redistribute their weight","type":"boolean"},"max_emission_share_per_fee_share":{"description":"Prune above this emission share / retained fee share; default 3","type":"number","minimum":1,"maximum":100}}},"annotations":{"readOnlyHint":true},"definitionHash":"b1c5911debdbef23aadc35acc1a0bd88833a527130acf59c6ddc72fa540b3338","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-17T08:46:23.638Z","metadataTrust":"untrusted"},{"serverName":"io.github.EkuboProtocol/ekubo","endpointFingerprint":"6e5c3b3d403bf28ec8578cc2c19eb69f275057f7dc780e2e2f0cda5542f9fd1f","name":"get_token","title":"Get an Ekubo token","description":"Fetch canonical token metadata for an exact chain and address.","inputSchema":{"type":"object","properties":{"chain_id":{"type":["integer","string"],"description":"EVM chain ID"},"address":{"type":"string","description":"EVM or Starknet token address (hex)"}},"required":["chain_id","address"]},"annotations":{"readOnlyHint":true},"definitionHash":"7476973a792bb8ebbf7a7c8e007db8ceb58f1ac8c161710ce02f1a10e71cf7d7","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-17T08:46:23.638Z","metadataTrust":"untrusted"},{"serverName":"io.github.EkuboProtocol/ekubo","endpointFingerprint":"6e5c3b3d403bf28ec8578cc2c19eb69f275057f7dc780e2e2f0cda5542f9fd1f","name":"get_tokens","title":"Get multiple Ekubo tokens","description":"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.","inputSchema":{"type":"object","properties":{"tokens":{"minItems":1,"type":"array","items":{"type":"object","properties":{"chain_id":{"type":["integer","string"],"description":"EVM chain ID"},"address":{"type":"string","description":"EVM or Starknet token address (hex)"}},"required":["chain_id","address"]},"description":"Entries may span chains"}},"required":["tokens"]},"annotations":{"readOnlyHint":true},"definitionHash":"6bba9534fe35e75e1ee1019f06cda5f341542e3a88720bafd76fb9233d45783b","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-17T08:46:23.638Z","metadataTrust":"untrusted"},{"serverName":"io.github.EkuboProtocol/ekubo","endpointFingerprint":"6e5c3b3d403bf28ec8578cc2c19eb69f275057f7dc780e2e2f0cda5542f9fd1f","name":"get_value_transfer_status","title":"Track a LayerZero or LI.FI cross-chain transfer","description":"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.","inputSchema":{"type":"object","properties":{"source":{"description":"The executed quote's source; defaults to layerzero","type":"string","enum":["layerzero","lifi"]},"quote_id":{"description":"The executed option's provider_quote_id; required for layerzero","type":"string","minLength":1},"transaction_hash":{"description":"Origin transaction hash; required for lifi, and pass it for layerzero once known (some routes need it) (bytes32 hex)","type":"string"},"origin_chain_id":{"type":["integer","string"],"description":"Origin chain; lifi only, narrows the lookup"},"destination_chain_id":{"type":["integer","string"],"description":"Destination chain; lifi only"}}},"annotations":{"readOnlyHint":true},"definitionHash":"105e9284d6fb484613ea3723eb13fd8e5a0a31a6e0f99048907c8e8ef11c9b32","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-17T08:46:23.638Z","metadataTrust":"untrusted"},{"serverName":"io.github.EkuboProtocol/ekubo","endpointFingerprint":"6e5c3b3d403bf28ec8578cc2c19eb69f275057f7dc780e2e2f0cda5542f9fd1f","name":"get_ve33_allocations","title":"Show Ekubo STONX / ve(3,3) allocations","description":"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.","inputSchema":{"type":"object","properties":{"chain_id":{"type":["integer","string"],"description":"Optional with ve_token; omit both for the production Ekubo STONX deployment"},"ve_token":{"description":"Optional with chain_id; omit both for the canonical STONX VeToken 0x9d7008E169D040B6c0140eb92E7cA82B12643497 (address)","type":"string"},"owner":{"type":"string","description":"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"}},"required":["owner"]},"annotations":{"readOnlyHint":true},"definitionHash":"5fbf3ca49d1cb59637a4fdf5cb7098bdb4bfc53c4e8aa72efac06b56732d0625","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-17T08:46:23.638Z","metadataTrust":"untrusted"},{"serverName":"io.github.EkuboProtocol/ekubo","endpointFingerprint":"6e5c3b3d403bf28ec8578cc2c19eb69f275057f7dc780e2e2f0cda5542f9fd1f","name":"list_pool_keys","title":"List Ekubo pool keys","description":"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).","inputSchema":{"type":"object","properties":{"chain_id":{"type":["integer","string"],"description":"EVM chain ID"},"core_address":{"type":"string","description":"Core deployment (address)"},"token_a":{"description":"Pools containing this token (address)","type":"string"},"token_b":{"description":"With token_a, the exact pair (address)","type":"string"},"extension":{"description":"Zero address = extensionless","type":"string"},"page_size":{"default":100,"description":"Pools per page","type":"integer","minimum":1,"maximum":200},"after_pool_id":{"description":"Previous page's next_after_pool_id (decimal or 0x-hex integer)","type":"string"}},"required":["chain_id","core_address"]},"annotations":{"readOnlyHint":true},"definitionHash":"3b9d778937af7a25d51e4084c1203c00d832eaa9e02387c7155b8f7d8b106105","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-17T08:46:23.638Z","metadataTrust":"untrusted"},{"serverName":"io.github.EkuboProtocol/ekubo","endpointFingerprint":"6e5c3b3d403bf28ec8578cc2c19eb69f275057f7dc780e2e2f0cda5542f9fd1f","name":"list_tokens","title":"List Ekubo tokens","description":"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.","inputSchema":{"type":"object","properties":{"chain_id":{"type":["integer","string"],"description":"Restrict the list to one EVM chain; omit to list tokens across every indexed chain"},"search":{"description":"Case-insensitive token symbol prefix or suffix match; omit to list the whole canonical set. Symbols only, not names or addresses","type":"string","minLength":1,"maxLength":32},"min_visibility_priority":{"description":"Lowest visibility_priority to include; defaults to 0, the interface threshold. Pass a negative value to reach tokens the interface hides","type":"integer","minimum":-100,"maximum":100},"page_size":{"description":"Maximum tokens to return; defaults to 20","type":"integer","minimum":1,"maximum":1000},"after_token":{"description":"Keep only tokens whose (chain_id, address) pair sorts after this <chain_id>:<address> identifier. Results are ordered by visibility_priority rather than by that pair, so this filters the candidate set instead of continuing a page boundary","type":"string","pattern":"^(?:[1-9][0-9]*|0x[0-9a-fA-F]+):0x[0-9a-fA-F]+$"}}},"annotations":{"readOnlyHint":true},"definitionHash":"5b9b3ab2b1a09df602068da2631f8d8a0c5454e33cfdcd7b3dab3827d47c75c9","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-17T08:46:23.638Z","metadataTrust":"untrusted"},{"serverName":"io.github.EkuboProtocol/ekubo","endpointFingerprint":"6e5c3b3d403bf28ec8578cc2c19eb69f275057f7dc780e2e2f0cda5542f9fd1f","name":"prepare_approval_revocations","title":"Prepare ERC-20 approval revocations","description":"Prepare every approve(spender,0) as an exact ordered multi-transaction execution plan. The wallet must not discover or construct the transaction list.","inputSchema":{"type":"object","properties":{"chain_id":{"type":["integer","string"],"description":"EVM chain ID"},"sender":{"type":"string","description":"address"},"approvals":{"minItems":1,"type":"array","items":{"type":"object","properties":{"token":{"type":"string","description":"address"},"spender":{"type":"string","description":"address"}},"required":["token","spender"]}}},"required":["chain_id","sender","approvals"]},"annotations":{"readOnlyHint":true},"definitionHash":"a01b9c5adf57d0a5cc46054692816b1985e36b29fe96b5bd6cce1acdcd58a3a4","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-17T08:46:23.638Z","metadataTrust":"untrusted"},{"serverName":"io.github.EkuboProtocol/ekubo","endpointFingerprint":"6e5c3b3d403bf28ec8578cc2c19eb69f275057f7dc780e2e2f0cda5542f9fd1f","name":"prepare_auction_complete","title":"Prepare auction completion","description":"Prepare permissionless auction completion and, when necessary, graduation-pool initialization in the same atomic batch.","inputSchema":{"type":"object","properties":{"chain_id":{"type":["integer","string"],"description":"EVM chain ID"},"sender":{"type":"string","description":"address"},"token_id":{"type":"string","description":"decimal or 0x-hex integer"},"auction_key":{"type":"object","description":"PoolKey {token0, token1, config}: token addresses (zero = native), bytes32 config"},"graduation_pool_initialized":{"type":"boolean"},"launch_pool_tick":{"type":"integer"}},"required":["chain_id","sender","token_id","auction_key","graduation_pool_initialized"]},"annotations":{"readOnlyHint":true},"definitionHash":"ad6c6e733582529cf6aaf2ca5cd662660b929072a0c5e47e144373b6a4510dc4","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-17T08:46:23.638Z","metadataTrust":"untrusted"},{"serverName":"io.github.EkuboProtocol/ekubo","endpointFingerprint":"6e5c3b3d403bf28ec8578cc2c19eb69f275057f7dc780e2e2f0cda5542f9fd1f","name":"prepare_auction_create","title":"Prepare auction creation","description":"Pack the exact interface auction config and prepare mint plus sellAmountByAuction, including approval or native value and deterministic token ID.","inputSchema":{"type":"object","properties":{"chain_id":{"type":["integer","string"],"description":"EVM chain ID"},"sender":{"type":"string","description":"address"},"sell_token":{"type":"string","description":"Token; zero address = native"},"buy_token":{"type":"string","description":"Token; zero address = native"},"sell_amount":{"type":"string","description":"Base units (positive decimal integer)"},"creator_fee_q32":{"type":"string","description":"decimal integer"},"min_boost_duration":{"type":"integer","minimum":0},"graduation_pool_fee_q64":{"type":"string","description":"decimal integer"},"graduation_pool_tick_spacing":{"type":"integer","minimum":0},"start_time":{"type":"string","description":"decimal integer"},"auction_duration":{"type":"integer","minimum":0},"salt":{"type":"string","description":"bytes32 hex"}},"required":["chain_id","sender","sell_token","buy_token","sell_amount","creator_fee_q32","min_boost_duration","graduation_pool_fee_q64","graduation_pool_tick_spacing","start_time","auction_duration","salt"]},"annotations":{"readOnlyHint":true},"definitionHash":"6261c713f76a0de95390cdf5152ab348878dab7c61a10b9f89d4084bc175cda8","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-17T08:46:23.638Z","metadataTrust":"untrusted"},{"serverName":"io.github.EkuboProtocol/ekubo","endpointFingerprint":"6e5c3b3d403bf28ec8578cc2c19eb69f275057f7dc780e2e2f0cda5542f9fd1f","name":"prepare_auction_creator_proceeds","title":"Prepare auction creator proceeds collection","description":"Prepare collection of creator proceeds for an auction NFT with pending owner validation.","inputSchema":{"type":"object","properties":{"chain_id":{"type":["integer","string"],"description":"EVM chain ID"},"sender":{"type":"string","description":"address"},"token_id":{"type":"string","description":"decimal or 0x-hex integer"},"auction_key":{"type":"object","description":"PoolKey {token0, token1, config}: token addresses (zero = native), bytes32 config"}},"required":["chain_id","sender","token_id","auction_key"]},"annotations":{"readOnlyHint":true},"definitionHash":"4c8afa5dd5f5a94b4d62ca3aa1565bfc4597fd2ec47b8c7312ce7b6a9bc7896b","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-17T08:46:23.638Z","metadataTrust":"untrusted"},{"serverName":"io.github.EkuboProtocol/ekubo","endpointFingerprint":"6e5c3b3d403bf28ec8578cc2c19eb69f275057f7dc780e2e2f0cda5542f9fd1f","name":"prepare_fix_pool_price","title":"Prepare a pool price correction","description":"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.","inputSchema":{"type":"object","properties":{"chain_id":{"type":["integer","string"],"description":"EVM chain ID"},"sender":{"type":"string","description":"address"},"core_address":{"type":"string","description":"address"},"pool_id":{"type":"string","description":"decimal or 0x-hex integer"},"base_token":{"type":"string","description":"Token; zero address = native"},"target_price":{"type":"string","pattern":"^(?:(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?|\\.[0-9]+)$"},"pending_current_sqrt_ratio":{"type":"string","description":"decimal integer"},"quote_result":{"type":"object","properties":{"specified_token":{"type":"string","description":"Token; zero address = native"},"calculated_token":{"type":"string","description":"Token; zero address = native"},"specified_amount":{"type":"string","description":"signed decimal integer"},"calculated_amount":{"type":"string","description":"signed decimal integer"},"block_number":{"type":"string","description":"decimal or 0x-hex integer"},"block_hash":{"type":"string","description":"bytes32 hex"}},"required":["specified_token","calculated_token","specified_amount","calculated_amount"]},"swap_deadline_minutes":{"description":"Ekubo router route deadline; default 30","type":"integer","minimum":1,"maximum":30}},"required":["chain_id","sender","core_address","pool_id","base_token","target_price"]},"annotations":{"readOnlyHint":true},"definitionHash":"e444e9b3c239f7346be9a00c53fd5e9a8e276a6e9d1cafa911521dcb8ca03c6d","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-17T08:46:23.638Z","metadataTrust":"untrusted"},{"serverName":"io.github.EkuboProtocol/ekubo","endpointFingerprint":"6e5c3b3d403bf28ec8578cc2c19eb69f275057f7dc780e2e2f0cda5542f9fd1f","name":"prepare_lp_position_deposit","title":"Prepare an LP position deposit","description":"Retired Ethereum MEVCapture v2.1 deposits are rejected; reads, claims and withdrawals remain available. 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.","inputSchema":{"type":"object","properties":{"chain_id":{"type":["integer","string"],"description":"EVM chain ID"},"sender":{"type":"string","description":"address"},"core_address":{"type":"string","description":"v3 Core address"},"pool_id":{"description":"Omit when pool_key is supplied (decimal or 0x-hex integer)","type":"string"},"pool_key":{"type":"object","description":"Required for an uninitialized pool. PoolKey {token0, token1, config}: token addresses (zero = native), bytes32 config"},"pool_initialized":{"description":"false only for a new pool to initialize here","type":"boolean"},"mode":{"default":"mint_new","type":"string","enum":["mint_new","add_liquidity"]},"token_id":{"description":"add_liquidity only (decimal or 0x-hex integer)","type":"string"},"tick_lower":{"type":"integer"},"tick_upper":{"type":"integer"},"initial_tick":{"description":"Uninitialized pool only: initializes at this tick","type":"integer"},"max_amount0":{"type":"string","description":"Max token0 base units; 0 for single-sided (decimal integer)"},"max_amount1":{"type":"string","description":"Max token1 base units; 0 for single-sided (decimal integer)"},"slippage_bps":{"type":"integer","minimum":1,"maximum":5000,"description":"User-selected liquidity slippage"}},"required":["chain_id","sender","core_address","tick_lower","tick_upper","max_amount0","max_amount1","slippage_bps"]},"annotations":{"readOnlyHint":true},"definitionHash":"19c75d26ad010a03710d171b593ecd754f5b188cfff0423b8af480a2837a7c88","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-17T08:46:23.638Z","metadataTrust":"untrusted"},{"serverName":"io.github.EkuboProtocol/ekubo","endpointFingerprint":"6e5c3b3d403bf28ec8578cc2c19eb69f275057f7dc780e2e2f0cda5542f9fd1f","name":"prepare_lp_position_earnings_claim","title":"Prepare an LP fee or reward claim","description":"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.","inputSchema":{"type":"object","properties":{"chain_id":{"type":["integer","string"],"description":"EVM chain ID"},"sender":{"type":"string","description":"Position owner (address)"},"positions_address":{"type":"string","description":"Positions or Ve33Positions manager (address)"},"token_id":{"type":"string","description":"Position NFT ID (decimal or 0x-hex integer)"},"recipient":{"description":"Defaults to sender (address)","type":"string"}},"required":["chain_id","sender","positions_address","token_id"]},"annotations":{"readOnlyHint":true},"definitionHash":"c57e04b2aaacc132e8428a84baabadc7e7f6ba38341693b3cf9e9dc68f6577bd","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-17T08:46:23.638Z","metadataTrust":"untrusted"}],"endpoints":[{"endpointFingerprint":"6e5c3b3d403bf28ec8578cc2c19eb69f275057f7dc780e2e2f0cda5542f9fd1f","protocol":"streamable-http","status":"indexed","toolCount":50,"observedAt":"2026-11-17T08:46:23.638Z"}],"authentication":"unknown"},"connectionConfigurations":{"status":"ready","authentication":"not embedded","clients":{"Claude Desktop":{"mcpServers":{"io.github.EkuboProtocol/ekubo":{"url":"https://mcp.ekubo.org/mcp"}}},"Cursor":{"mcpServers":{"io.github.EkuboProtocol/ekubo":{"url":"https://mcp.ekubo.org/mcp"}}},"VS Code":{"servers":{"io.github.EkuboProtocol/ekubo":{"type":"http","url":"https://mcp.ekubo.org/mcp"}}}}},"resourceType":"mcp-server","callable":true,"runtime":{"callable":true,"protocols":["mcp"]},"interfaces":[{"protocol":"mcp","transport":"streamable-http","url":"https://mcp.ekubo.org/mcp"}],"profile":{"apiVersion":"1","schemaVersion":"1","id":"mcp-server:io.github.EkuboProtocol%2Fekubo","resourceType":"mcp-server","canonicalUrl":"https://www.agentsjunction.com/api/v1/servers/io.github.EkuboProtocol%2Fekubo","name":"io.github.EkuboProtocol/ekubo","description":"Token and pool data, swap quotes, and unsigned transaction plans for Ekubo and other DeFi protocols.","interfaces":[{"protocol":"mcp","transport":"streamable-http","url":"https://mcp.ekubo.org/mcp"}],"capabilities":[],"identity":{"source":"official-registry","websiteUrl":"https://docs.ekubo.org/products/mcp-server/","repositoryUrl":"https://github.com/EkuboProtocol/ekubo-mcp-server","version":"0.54.0"},"verification":{"state":"official","confidence":100},"operations":{"resourceType":"mcp-server","name":"io.github.EkuboProtocol/ekubo","status":"online","lastCheckedAt":"2026-11-20T05:16:21.801Z","lastSuccessfulCheck":"2026-11-20T05:16:21.801Z","latencyMs":449,"consecutiveFailures":0,"isStale":false,"checks":{"endpointReachable":true,"protocolValid":true,"agentCardValid":null,"mcpHandshakeValid":true},"lastSeen":null,"lastSuccessfulInteraction":null,"lastHealthCheck":"2026-11-20T05:16:21.801Z","source":{"type":"health-check","url":null},"observedAt":"2026-11-20T05:16:21.801Z"},"security":null,"timestamps":{"createdAt":"2026-11-04T16:38:12.078Z","updatedAt":"2026-11-04T16:38:12.078Z","observedAt":"2026-11-20T05:16:21.801Z"},"compatibility":{"serverVersion":"0.54.0","protocolVersions":[{"protocol":"mcp","version":null}]}}}}