io.github.EkuboProtocol/ekubo

up checked 2026-11-10T18:37:32.442Z

Unclaimed · Unverified

Agent searches it appeared in, last 30 days: 0. Run this server? Claim the listing: verified label, uptime alerts and analytics.

Publisher-provided title

Ekubo Protocol

Publisher-provided description

Token and pool data, swap quotes, and unsigned transaction plans for Ekubo and other DeFi protocols.

Summary by lookupd

Look up Ekubo pools, token metadata and positions, get swap quotes, and prepare unsigned liquidity, transfer and vote transactions.

Install

Claude Code, remote (streamable-http)

claude mcp add --transport http ekubo https://mcp.ekubo.org/mcp

Codex, remote (streamable-http)

codex mcp add ekubo --url https://mcp.ekubo.org/mcp

Cursor, remote (streamable-http) → .cursor/mcp.json

{
  "mcpServers": {
    "ekubo": {
      "url": "https://mcp.ekubo.org/mcp"
    }
  }
}

Other clients: docs. Or tell your agent: Set up lookupd for me: read https://lookupd.com/agent.md and follow it.

Tools (showing 30 of 99)

Publisher-provided text

• list_tokens First step for symbol-based swaps, including tokenized stocks and stablecoins: list canonical Ekubo tokens by descending visibility_priority, so the preferred t
• export_tokens 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 u
• get_token Fetch canonical token metadata for an exact chain and address.
• get_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.
• get_quotes_with_plans A quote, execution plan, simulation or wallet approval is not permission to trade. Robinhood Stock Tokens are tokenised debt securities subject to issuer restri
• get_value_transfer_status 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 se
• prepare_ve33_vote Compile one actively voted ve-token into multiple allocations. Unconditionally claims its current pool first, then splits and changes votes in one atomic batch
• prepare_ve33_extend 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
• prepare_ve33_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
• prepare_ve33_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
• prepare_ve33_claim_fees 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, an
• prepare_ve33_reinvest 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
• prepare_ve33_claim_all_fees 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
• prepare_ve33_clear_vote 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 instea
• get_ve33_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
• get_stonx_allocation_recommendation 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 2
• prepare_ve33_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, sp
• get_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_s
• get_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.r
• get_pool_liquidity 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.
• list_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 p
• derive_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 roun
• decode_pool_config Decode the packed bytes32 extension, exact uint64 Q64 fee, concentrated/stableswap discriminator, and tick spacing or stableswap parameters. The fee is never re
• get_position Hydrate one owner position: pool key, bounds, liquidity, pool state, NFT metadata, history, rewards, token prices, and a pending read of current principal, fees
• get_position_pool_candidates 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 Posit
• prepare_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 u
• prepare_lp_position_earnings_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_st
• prepare_lp_position_withdraw 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 cur
• prepare_wrap_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 e
• prepare_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 a

Details

• Version: 0.54.0
• Transports: streamable-http
• Uptime (7 days): 100%
• Median latency: 675 ms
• First indexed: 2026-11-04T17:17:16.955Z
• Last seen in registry: 2026-11-04T17:17:16.955Z
• Repository: https://github.com/EkuboProtocol/ekubo-mcp-server
• Website: https://docs.ekubo.org/products/mcp-server/

Badge for your README

Shows this live status and links here; updates hourly.

[![lookupd status](https://lookupd.com/badge/io.github.EkuboProtocol/ekubo.svg)](https://lookupd.com/servers/io.github.EkuboProtocol/ekubo)

• 62092 servers
• Last crawl: 2026-11-11T17:17:22.074Z
• API base: https://api.lookupd.com
• MCP URL: https://api.lookupd.com/mcp