SODAX Builders MCP

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Cross-network DeFi API data, AMM analytics, and SDK docs for 17+ networks.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "SODAX Builders MCP": {
      "url": "https://builders.sodax.com/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (37)

• sodax_get_supported_chains read-only

  List all blockchain networks supported by SODAX for cross-chain swaps and DeFi operations

  Parameters:

  • format — string — Response format: 'json' for raw data or 'markdown' for formatted text

  Hints: read-only yes · destructive no · idempotent not declared · open-world yes

• sodax_get_swap_tokens read-only

  Get available tokens for swapping on SODAX, optionally filtered by chain

  Parameters:

  • format — string — Response format: 'json' for raw data or 'markdown' for formatted text
  • chainId — string — Filter tokens by spoke chain ID. Use the formal chain ID (e.g., '0x2105.base', 'ethereum', 'sonic', '0x1.icon', '0xa.optimism'). Call sodax_get_supported_chains for the full list.

  Hints: read-only yes · destructive no · idempotent not declared · open-world yes

• sodax_get_transaction read-only

  Look up a specific transaction by its hash to see status, amounts, and details

  Parameters:

  • txHash (required) — string — The transaction hash to look up (e.g., '0x...')
  • format — string — Response format: 'json' for raw data or 'markdown' for formatted text

  Hints: read-only yes · destructive no · idempotent not declared · open-world yes

• sodax_get_user_transactions read-only

  Get intent/transaction history for a specific wallet address

  Parameters:

  • userAddress (required) — string — The wallet address to look up (e.g., '0x...')
  • limit — number — Maximum number of transactions to return (1-100)
  • format — string — Response format: 'json' for raw data or 'markdown' for formatted text
  • offset — number — Number of transactions to skip for pagination
  • toBlock — number — Inclusive upper bound on blockNumber (chain-native ordering)
  • fromBlock — number — Inclusive lower bound on blockNumber (chain-native ordering)

  Hints: read-only yes · destructive no · idempotent not declared · open-world yes

• sodax_get_volume read-only

  Get solver volume data showing filled intents with filtering and pagination. Requires inputToken and outputToken. Optional filters: chain, solver, block range OR time range (don't mix both).

  Parameters:

  • inputToken (required) — string — REQUIRED: Input token address
  • outputToken (required) — string — REQUIRED: Output token address
  • sort — string — Sort order by block number
  • toTs — number — End timestamp (unix seconds). Don't mix with since/until or fromBlock/toBlock.
  • limit — number — Maximum number of filled intents to return (1-100)
  • since — string — Start time ISO format (don't mix with fromBlock/toBlock or fromTs/toTs)
  • until — string — End time ISO format (don't mix with fromBlock/toBlock or fromTs/toTs)
  • cursor — string — Pagination cursor from previous response's nextCursor
  • format — string — Response format: 'json' for raw data or 'markdown' for formatted text
  • fromTs — number — Start timestamp (unix seconds). Don't mix with since/until or fromBlock/toBlock.
  • solver — string — Filter by solver address (0x0...0 for default solver)
  • chainId — number — Filter by chain ID (e.g., 146 for Sonic)
  • toBlock — number — End block number (don't mix with since/until)
  • fromBlock — number — Start block number (don't mix with since/until)
  • includeData — boolean — Include raw intent data in response

  Hints: read-only yes · destructive no · idempotent not declared · open-world yes

• sodax_get_volume_stats read-only

  Get aggregate solver volume stats: the approximate total number of filled-intent records (fill documents, not distinct intents). Cached ~60s upstream.

  Parameters:

  • format — string — Response format: 'json' for raw data or 'markdown' for formatted text

  Hints: read-only yes · destructive no · idempotent not declared · open-world yes

• sodax_get_orderbook read-only

  Get current orderbook entries showing pending/open intents

  Parameters:

  • limit — number — Max results (default server-side, cap 500)
  • format — string — Response format: 'json' for raw data or 'markdown' for formatted text
  • offset — number — Offset for simple pagination
  • creator — string — Filter by creator address
  • dstChain — number — Filter by destination chain id
  • srcChain — number — Filter by source chain id
  • inputToken — string — Filter by input token address
  • outputToken — string — Filter by output token address
  • deadlineAfter — number — Only return intents with deadline > value (Unix seconds)
  • deadlineBefore — number — Only return intents with deadline < value (Unix seconds)
  • excludeZeroDeadline — boolean — Exclude intents where deadline = 0

  Hints: read-only yes · destructive no · idempotent not declared · open-world yes

• sodax_get_money_market_assets read-only

  List all assets available for lending and borrowing in the SODAX money market

  Parameters:

  • format — string — Response format: 'json' for raw data or 'markdown' for formatted text
  • chainId — string — Filter by chain ID

  Hints: read-only yes · destructive no · idempotent not declared · open-world yes

• sodax_get_user_position read-only

  Get a user's lending and borrowing position in the money market

  Parameters:

  • userAddress (required) — string — The wallet address to look up
  • format — string — Response format: 'json' for raw data or 'markdown' for formatted text

  Hints: read-only yes · destructive no · idempotent not declared · open-world yes

• sodax_get_partners read-only

  List all SODAX integration partners including wallets, DEXs, and other protocols

  Parameters:

  • format — string — Response format: 'json' for raw data or 'markdown' for formatted text
  • chainId — integer — Filter partners by numeric chain ID (e.g. 146 for Sonic)

  Hints: read-only yes · destructive no · idempotent not declared · open-world yes

• sodax_get_token_supply read-only

  Get SODA token supply information including total, circulating, and burned amounts

  Parameters:

  • format — string — Response format: 'json' for raw data or 'markdown' for formatted text

  Hints: read-only yes · destructive no · idempotent not declared · open-world yes

• sodax_get_all_config read-only

  Get full SODAX configuration including all supported chains, swap tokens, and protocol settings in one call

  Parameters:

  • format — string — Response format: 'json' for raw data or 'markdown' for formatted text

  Hints: read-only yes · destructive no · idempotent not declared · open-world yes

• sodax_get_relay_chain_id_map read-only

  Get mapping between chain IDs and intent relay chain IDs used by the SODAX relay network

  Parameters:

  • format — string — Response format: 'json' for raw data or 'markdown' for formatted text

  Hints: read-only yes · destructive no · idempotent not declared · open-world yes

• sodax_get_all_chains_configs read-only

  Get detailed configuration for all spoke chains including contract addresses, RPCs, and token configs

  Parameters:

  • format — string — Response format: 'json' for raw data or 'markdown' for formatted text

  Hints: read-only yes · destructive no · idempotent not declared · open-world yes

• sodax_get_hub_assets read-only

  Get assets representing spoke tokens on the hub (Sonic) chain, optionally filtered by source chain

  Parameters:

  • format — string — Response format: 'json' for raw data or 'markdown' for formatted text
  • chainId — string — Filter by source spoke chain ID. Use the formal chain ID (e.g., '0x2105.base', 'ethereum', 'sonic'). Call sodax_get_supported_chains for the full list.

  Hints: read-only yes · destructive no · idempotent not declared · open-world yes

• sodax_get_money_market_tokens read-only

  Get tokens supported for money market lending/borrowing, optionally filtered by chain

  Parameters:

  • format — string — Response format: 'json' for raw data or 'markdown' for formatted text
  • chainId — string — Filter by chain ID

  Hints: read-only yes · destructive no · idempotent not declared · open-world yes

• sodax_get_money_market_reserve_assets read-only

  Get money market reserve assets used as collateral backing

  Parameters:

  • format — string — Response format: 'json' for raw data or 'markdown' for formatted text

  Hints: read-only yes · destructive no · idempotent not declared · open-world yes

• sodax_get_amm_positions read-only

  Get AMM liquidity provider NFT positions, optionally filtered by owner address

  Parameters:

  • limit — number — Maximum number of positions to return
  • owner — string — Filter by owner wallet address
  • format — string — Response format: 'json' for raw data or 'markdown' for formatted text
  • offset — number — Number of positions to skip for pagination

  Hints: read-only yes · destructive no · idempotent not declared · open-world yes

• sodax_get_amm_pool_candles read-only

  Get OHLCV candlestick chart data for an AMM pool

  Parameters:

  • chainId (required) — string — Chain ID where the pool is deployed (e.g., 'sonic')
  • poolId (required) — string — The pool contract address or ID
  • interval (required) — string — REQUIRED: Candle interval
  • from (required) — number — REQUIRED: Start timestamp (unix seconds)
  • to (required) — number — REQUIRED: End timestamp (unix seconds)
  • format — string — Response format: 'json' for raw data or 'markdown' for formatted text

  Hints: read-only yes · destructive no · idempotent not declared · open-world yes

• sodax_get_intent read-only

  Look up a specific intent by its intent hash (different from transaction hash)

  Parameters:

  • intentHash (required) — string — The intent hash to look up (66 character hex string starting with 0x)
  • format — string — Response format: 'json' for raw data or 'markdown' for formatted text

  Hints: read-only yes · destructive no · idempotent not declared · open-world yes

• sodax_get_solver_intent read-only

  Get solver-side details for an intent including fill history. Use includeAll to see all solver documents.

  Parameters:

  • intentHash (required) — string — The intent hash to look up
  • format — string — Response format: 'json' for raw data or 'markdown' for formatted text
  • includeAll — boolean — Include all intent documents (history) instead of just the latest

  Hints: read-only yes · destructive no · idempotent not declared · open-world yes

• sodax_get_money_market_asset read-only

  Get detailed information for a specific money market asset by its reserve address

  Parameters:

  • reserveAddress (required) — string — The reserve contract address of the asset
  • format — string — Response format: 'json' for raw data or 'markdown' for formatted text

  Hints: read-only yes · destructive no · idempotent not declared · open-world yes

• sodax_get_asset_borrowers read-only

  Get borrowers for a specific money market asset by its reserve address

  Parameters:

  • reserveAddress (required) — string — The reserve contract address of the asset
  • limit — number — Maximum number of borrowers to return (1-100)
  • format — string — Response format: 'json' for raw data or 'markdown' for formatted text
  • offset — number — Number of borrowers to skip for pagination

  Hints: read-only yes · destructive no · idempotent not declared · open-world yes

• sodax_get_asset_suppliers read-only

  Get suppliers (lenders) for a specific money market asset by its reserve address

  Parameters:

  • reserveAddress (required) — string — The reserve contract address of the asset
  • limit — number — Maximum number of suppliers to return (1-100)
  • format — string — Response format: 'json' for raw data or 'markdown' for formatted text
  • offset — number — Number of suppliers to skip for pagination

  Hints: read-only yes · destructive no · idempotent not declared · open-world yes

• sodax_get_all_borrowers read-only

  Get all borrowers across all money market assets with pagination

  Parameters:

  • limit — number — Maximum number of borrowers to return (1-100)
  • format — string — Response format: 'json' for raw data or 'markdown' for formatted text
  • offset — number — Number of borrowers to skip for pagination

  Hints: read-only yes · destructive no · idempotent not declared · open-world yes

• sodax_get_partner_summary read-only

  Get volume and activity summary for a specific integration partner by their receiver address

  Parameters:

  • receiver (required) — string — The partner receiver address
  • format — string — Response format: 'json' for raw data or 'markdown' for formatted text
  • chainId — string — Filter by chain ID

  Hints: read-only yes · destructive no · idempotent not declared · open-world yes

• sodax_get_total_supply read-only

  Get SODA token total supply as a plain number

  Parameters:

  • format — string — Response format: 'json' for raw data or 'markdown' for formatted text

  Hints: read-only yes · destructive no · idempotent not declared · open-world yes

• sodax_get_circulating_supply read-only

  Get SODA token circulating supply as a plain number

  Parameters:

  • format — string — Response format: 'json' for raw data or 'markdown' for formatted text

  Hints: read-only yes · destructive no · idempotent not declared · open-world yes

• sodax_refresh_cache

  Clear both the backend API cache and the solver oracle cache to force fresh fetches on next requests. Reports the number of entries cleared per cache.

  Hints: read-only no · destructive no · idempotent yes · open-world not declared

• sodax_get_solver_oracle read-only

  Get the solver's oracle USD prices per (chain, token). For quoting with sodax_get_solver_quote, filter chainId='146': chainId-146 addresses pass the quote service's compatibility check, while spoke-chain (non-146) addresses are rejected with 'not compatible with the quote service'. Caveat: passing that check (being listed/priced) does NOT guarantee a swap route — canonical bridged *_ASSET hub tokens and major stablecoins route most reliably, while many wrapped/derivative/money-market entries (e.g. WBTC, waLocBTC, SONIC_SODA_ASSET) are priced but frequently return 'No path was found', and routability is pair/amount/liquidity-dependent. Also useful for sanity-checking quote amounts against the USD prices the solver uses.

  Parameters:

  • format — string — Response format: 'json' for raw data or 'markdown' for formatted text
  • symbol — string — Filter by token symbol (case-insensitive exact match, e.g. 'SODA', 'bnUSD')
  • chainId — string — Filter results to a single intent-relay chain ID (decimal string, e.g. '146' for Sonic). Call sodax_get_relay_chain_id_map to translate.

  Hints: read-only yes · destructive no · idempotent not declared · open-world yes

• sodax_get_solver_quote read-only

  Get a swap quote from the SODAX solver. tokenSrc/tokenDst MUST be hub-chain (Sonic, chainId 146) asset addresses — look them up with sodax_get_solver_oracle (chainId='146'). Working example: tokenSrc='0xeb0393893b5bf98a50073d6740738b08e575058b' (BTC_BTC_ASSET) → tokenDst='0xaeafa26e43f46cd83efe89b1e57c858eb5685a24' (ETH_ASSET), amount='99800', quoteType='exact_input' returns a quoted_amount. exact_input quotes the destination amount you'd receive; exact_output quotes the source amount you'd need. There are two distinct HTTP-400 failures, both naming the two addresses: (1) 'not compatible with the quote service' = an address isn't a recognized hub asset (a spoke-chain or otherwise non-chainId-146 address was passed) → use a chainId-146 address from sodax_get_solver_oracle, and for a reliable pick prefer a canonical bridged *_ASSET hub token or major stablecoin (chainId 146 alone doesn't guarantee a route). (2) 'No path was found between X and Y' = both tokens are valid hub assets but the solver couldn't route this pair for this amount → routing is pair/amount/liquidity-dependent, so retry with a smaller amount or a more liquid counterparty (a canonical bridged *_ASSET token, or a major stablecoin like SONIC_USDC_ASSET). Many wrapped/derivative entries (e.g. WBTC, waLocBTC, SONIC_SODA_ASSET) are oracle-priced but frequently have no route — prefer canonical bridged *_ASSET hub tokens.

  Parameters:

  • tokenSrc (required) — string — REQUIRED: Source token address (the token you're spending). Hub-chain (Sonic, chainId 146) asset address from sodax_get_solver_oracle. Prefer canonical bridged *_ASSET tokens (e.g. BTC_BTC_ASSET 0xeb0393893b5bf98a50073d6740738b08e575058b); wrapped/derivative entries like WBTC are priced but frequently have no route.
  • tokenDst (required) — string — REQUIRED: Destination token address (the token you want to receive). Hub-chain (Sonic, chainId 146) asset address from sodax_get_solver_oracle (e.g. ETH_ASSET 0xaeafa26e43f46cd83efe89b1e57c858eb5685a24). Prefer canonical bridged *_ASSET tokens or a major stablecoin for a routable pair.
  • amount (required) — string — REQUIRED: Amount in the smallest unit of the input token (for exact_input) or output token (for exact_output). String to preserve precision. Note: a very large amount can exceed available liquidity and return 'No path was found' even for an otherwise-valid pair — reduce it if that happens.
  • format — string — Response format: 'json' for raw data or 'markdown' for formatted text
  • quoteType — string — 'exact_input' (default): given input amount, quote output amount. 'exact_output': given output amount, quote input amount required.

  Hints: read-only yes · destructive no · idempotent not declared · open-world yes

• sodax_relay_submit_tx

  Submit a confirmed spoke-chain transaction to the SODAX intent relay so it can be delivered to the destination chain. The tx must already be finalized on the source chain. Re-submitting the same tx is a no-op. For split-tx chains (Solana, Bitcoin) supply the optional `data` argument.

  Parameters:

  • chainId (required) — string — REQUIRED: Intent-relay chain ID of the source chain (decimal string, e.g. '146' for Sonic, '2' for Ethereum). Call sodax_get_relay_chain_id_map to translate from a chain key.
  • txHash (required) — string — REQUIRED: The confirmed transaction hash on the source chain
  • data — object — Required only for split-tx chains (Solana, Bitcoin). Omit for EVM chains.
  • format — string — Response format: 'json' for raw data or 'markdown' for formatted text

  Hints: read-only no · destructive no · idempotent yes · open-world yes

• sodax_relay_get_transaction_packets read-only

  List every cross-chain packet emitted by a given source transaction. Use this to track relay status — a packet is complete when status='executed' and dst_tx_hash is populated.

  Parameters:

  • chainId (required) — string — REQUIRED: Intent-relay chain ID of the source chain (decimal string, e.g. '146'). Call sodax_get_relay_chain_id_map to translate from a chain key.
  • txHash (required) — string — REQUIRED: The source-chain transaction hash whose packets you want to inspect
  • format — string — Response format: 'json' for raw data or 'markdown' for formatted text

  Hints: read-only yes · destructive no · idempotent not declared · open-world yes

• sodax_relay_get_packet read-only

  Fetch a single relay packet by its connection serial number (conn_sn). Returns the packet data on success or a `{success:false, message}` shape if the packet isn't found.

  Parameters:

  • chainId (required) — string — REQUIRED: Intent-relay chain ID of the source chain (decimal string)
  • txHash (required) — string — REQUIRED: The source-chain transaction hash
  • connSn — string — REQUIRED: Connection serial number identifying the packet within the tx. Accepts string or number (numeric values are coerced — convenient for piping back a previously-fetched packet's `conn_sn` field).
  • format — string — Response format: 'json' for raw data or 'markdown' for formatted text

  Hints: read-only yes · destructive no · idempotent not declared · open-world yes

• docs_health read-only

  Check SDK documentation availability. Call this first if docs tools seem unavailable.

  Hints: read-only yes · destructive no · idempotent not declared · open-world yes

• docs_refresh

  Reconnect to SDK documentation and refresh available tools. Use if docs seem stale or unavailable.

  Hints: read-only no · destructive no · idempotent yes · open-world not declared

• docs_list_tools read-only

  List all SDK documentation tools with parameters. Essential for discovering what's available.

  Hints: read-only yes · destructive no · idempotent not declared · open-world yes

Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.