SODAX Builders MCP
gosodax/builders-sodax-mcp-server
This connects your AI assistant to SODAX's cross-chain DeFi infrastructure across 17+ blockchains. You get live access to swap tokens, money market rates, solver volume, intent history, and AMM analytics through 33 API tools. Query oracle prices, get swap quotes, track cross-chain relay packets, check lending APYs, or look up user positions. The server also proxies SODAX's GitBook documentation so you can search SDK guides and integration examples without leaving your editor. Cache is set to 2 minutes for most endpoints. Works over streamable HTTP or SSE fallback. Useful when you're building cross-network integrations and need real-time protocol data alongside code examples in the same context window.
- tools
- 37
- transport
- HTTP
- last updated
- Mar 23, 2026
Install
From registry metadata$ npx add-mcp https://builders.sodax.com/mcp --name builders-mcpRun in your terminal. add-mcp asks which agents to add it to (Claude Code, Codex, Cursor and more). Add -g to install it for every project.
Review the command, arguments and environment values before installing. MCP servers run with your local permissions.
Other ways
Claude Code
$ claude mcp add --transport http builders-mcp https://builders.sodax.com/mcpRun in your terminal. Add --scope user to make it available in every project.
Tools
Verified live · 37 toolsVerified live against the running server on Nov 6, 2026.
sodax_get_supported_chainsList all blockchain networks supported by SODAX for cross-chain swaps and DeFi operations1 params
List all blockchain networks supported by SODAX for cross-chain swaps and DeFi operations
Parameters* required
formatstringResponse format: 'json' for raw data or 'markdown' for formatted textone of
json · markdowndefault: markdownsodax_get_swap_tokensGet available tokens for swapping on SODAX, optionally filtered by chain2 params
Get available tokens for swapping on SODAX, optionally filtered by chain
Parameters* required
chainIdstringFilter 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.
formatstringResponse format: 'json' for raw data or 'markdown' for formatted textone of
json · markdowndefault: markdownsodax_get_transactionLook up a specific transaction by its hash to see status, amounts, and details2 params
Look up a specific transaction by its hash to see status, amounts, and details
Parameters* required
formatstringResponse format: 'json' for raw data or 'markdown' for formatted textone of
json · markdowndefault: markdowntxHash*stringThe transaction hash to look up (e.g., '0x...')
sodax_get_user_transactionsGet intent/transaction history for a specific wallet address6 params
Get intent/transaction history for a specific wallet address
Parameters* required
formatstringResponse format: 'json' for raw data or 'markdown' for formatted textone of
json · markdowndefault: markdownfromBlocknumberInclusive lower bound on blockNumber (chain-native ordering)
limitnumberMaximum number of transactions to return (1-100)default: 20
offsetnumberNumber of transactions to skip for paginationdefault: 0
toBlocknumberInclusive upper bound on blockNumber (chain-native ordering)
userAddress*stringThe wallet address to look up (e.g., '0x...')
sodax_get_volumeGet 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).15 params
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* required
chainIdnumberFilter by chain ID (e.g., 146 for Sonic)
cursorstringPagination cursor from previous response's nextCursor
formatstringResponse format: 'json' for raw data or 'markdown' for formatted textone of
json · markdowndefault: markdownfromBlocknumberStart block number (don't mix with since/until)
fromTsnumberStart timestamp (unix seconds). Don't mix with since/until or fromBlock/toBlock.
includeDatabooleanInclude raw intent data in responsedefault: false
inputToken*stringREQUIRED: Input token address
limitnumberMaximum number of filled intents to return (1-100)default: 50
outputToken*stringREQUIRED: Output token address
sincestringStart time ISO format (don't mix with fromBlock/toBlock or fromTs/toTs)
solverstringFilter by solver address (0x0...0 for default solver)
sortstringSort order by block numberone of
asc · descdefault: desctoBlocknumberEnd block number (don't mix with since/until)
toTsnumberEnd timestamp (unix seconds). Don't mix with since/until or fromBlock/toBlock.
untilstringEnd time ISO format (don't mix with fromBlock/toBlock or fromTs/toTs)
sodax_get_volume_statsGet aggregate solver volume stats: the approximate total number of filled-intent records (fill documents, not distinct intents). Cached ~60s upstream.1 params
Get aggregate solver volume stats: the approximate total number of filled-intent records (fill documents, not distinct intents). Cached ~60s upstream.
Parameters* required
formatstringResponse format: 'json' for raw data or 'markdown' for formatted textone of
json · markdowndefault: markdownsodax_get_orderbookGet current orderbook entries showing pending/open intents11 params
Get current orderbook entries showing pending/open intents
Parameters* required
creatorstringFilter by creator address
deadlineAfternumberOnly return intents with deadline > value (Unix seconds)
deadlineBeforenumberOnly return intents with deadline < value (Unix seconds)
dstChainnumberFilter by destination chain id
excludeZeroDeadlinebooleanExclude intents where deadline = 0
formatstringResponse format: 'json' for raw data or 'markdown' for formatted textone of
json · markdowndefault: markdowninputTokenstringFilter by input token address
limitnumberMax results (default server-side, cap 500)
offsetnumberOffset for simple pagination
outputTokenstringFilter by output token address
srcChainnumberFilter by source chain id
sodax_get_money_market_assetsList all assets available for lending and borrowing in the SODAX money market2 params
List all assets available for lending and borrowing in the SODAX money market
Parameters* required
chainIdstringFilter by chain ID
formatstringResponse format: 'json' for raw data or 'markdown' for formatted textone of
json · markdowndefault: markdownsodax_get_user_positionGet a user's lending and borrowing position in the money market2 params
Get a user's lending and borrowing position in the money market
Parameters* required
formatstringResponse format: 'json' for raw data or 'markdown' for formatted textone of
json · markdowndefault: markdownuserAddress*stringThe wallet address to look up
sodax_get_partnersList all SODAX integration partners including wallets, DEXs, and other protocols2 params
List all SODAX integration partners including wallets, DEXs, and other protocols
Parameters* required
chainIdintegerFilter partners by numeric chain ID (e.g. 146 for Sonic)
formatstringResponse format: 'json' for raw data or 'markdown' for formatted textone of
json · markdowndefault: markdownsodax_get_token_supplyGet SODA token supply information including total, circulating, and burned amounts1 params
Get SODA token supply information including total, circulating, and burned amounts
Parameters* required
formatstringResponse format: 'json' for raw data or 'markdown' for formatted textone of
json · markdowndefault: markdownsodax_get_all_configGet full SODAX configuration including all supported chains, swap tokens, and protocol settings in one call1 params
Get full SODAX configuration including all supported chains, swap tokens, and protocol settings in one call
Parameters* required
formatstringResponse format: 'json' for raw data or 'markdown' for formatted textone of
json · markdowndefault: markdownsodax_get_relay_chain_id_mapGet mapping between chain IDs and intent relay chain IDs used by the SODAX relay network1 params
Get mapping between chain IDs and intent relay chain IDs used by the SODAX relay network
Parameters* required
formatstringResponse format: 'json' for raw data or 'markdown' for formatted textone of
json · markdowndefault: markdownsodax_get_all_chains_configsGet detailed configuration for all spoke chains including contract addresses, RPCs, and token configs1 params
Get detailed configuration for all spoke chains including contract addresses, RPCs, and token configs
Parameters* required
formatstringResponse format: 'json' for raw data or 'markdown' for formatted textone of
json · markdowndefault: markdownsodax_get_hub_assetsGet assets representing spoke tokens on the hub (Sonic) chain, optionally filtered by source chain2 params
Get assets representing spoke tokens on the hub (Sonic) chain, optionally filtered by source chain
Parameters* required
chainIdstringFilter 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.
formatstringResponse format: 'json' for raw data or 'markdown' for formatted textone of
json · markdowndefault: markdownsodax_get_money_market_tokensGet tokens supported for money market lending/borrowing, optionally filtered by chain2 params
Get tokens supported for money market lending/borrowing, optionally filtered by chain
Parameters* required
chainIdstringFilter by chain ID
formatstringResponse format: 'json' for raw data or 'markdown' for formatted textone of
json · markdowndefault: markdownsodax_get_money_market_reserve_assetsGet money market reserve assets used as collateral backing1 params
Get money market reserve assets used as collateral backing
Parameters* required
formatstringResponse format: 'json' for raw data or 'markdown' for formatted textone of
json · markdowndefault: markdownsodax_get_amm_positionsGet AMM liquidity provider NFT positions, optionally filtered by owner address4 params
Get AMM liquidity provider NFT positions, optionally filtered by owner address
Parameters* required
formatstringResponse format: 'json' for raw data or 'markdown' for formatted textone of
json · markdowndefault: markdownlimitnumberMaximum number of positions to return
offsetnumberNumber of positions to skip for pagination
ownerstringFilter by owner wallet address
sodax_get_amm_pool_candlesGet OHLCV candlestick chart data for an AMM pool6 params
Get OHLCV candlestick chart data for an AMM pool
Parameters* required
chainId*stringChain ID where the pool is deployed (e.g., 'sonic')
formatstringResponse format: 'json' for raw data or 'markdown' for formatted textone of
json · markdowndefault: markdownfrom*numberREQUIRED: Start timestamp (unix seconds)
interval*stringREQUIRED: Candle intervalone of
1m · 5m · 15m · 1h · 4h · 1dpoolId*stringThe pool contract address or ID
to*numberREQUIRED: End timestamp (unix seconds)
sodax_get_intentLook up a specific intent by its intent hash (different from transaction hash)2 params
Look up a specific intent by its intent hash (different from transaction hash)
Parameters* required
formatstringResponse format: 'json' for raw data or 'markdown' for formatted textone of
json · markdowndefault: markdownintentHash*stringThe intent hash to look up (66 character hex string starting with 0x)
sodax_get_solver_intentGet solver-side details for an intent including fill history. Use includeAll to see all solver documents.3 params
Get solver-side details for an intent including fill history. Use includeAll to see all solver documents.
Parameters* required
formatstringResponse format: 'json' for raw data or 'markdown' for formatted textone of
json · markdowndefault: markdownincludeAllbooleanInclude all intent documents (history) instead of just the latestdefault: false
intentHash*stringThe intent hash to look up
sodax_get_money_market_assetGet detailed information for a specific money market asset by its reserve address2 params
Get detailed information for a specific money market asset by its reserve address
Parameters* required
formatstringResponse format: 'json' for raw data or 'markdown' for formatted textone of
json · markdowndefault: markdownreserveAddress*stringThe reserve contract address of the asset
sodax_get_asset_borrowersGet borrowers for a specific money market asset by its reserve address4 params
Get borrowers for a specific money market asset by its reserve address
Parameters* required
formatstringResponse format: 'json' for raw data or 'markdown' for formatted textone of
json · markdowndefault: markdownlimitnumberMaximum number of borrowers to return (1-100)default: 20
offsetnumberNumber of borrowers to skip for paginationdefault: 0
reserveAddress*stringThe reserve contract address of the asset
sodax_get_asset_suppliersGet suppliers (lenders) for a specific money market asset by its reserve address4 params
Get suppliers (lenders) for a specific money market asset by its reserve address
Parameters* required
formatstringResponse format: 'json' for raw data or 'markdown' for formatted textone of
json · markdowndefault: markdownlimitnumberMaximum number of suppliers to return (1-100)default: 20
offsetnumberNumber of suppliers to skip for paginationdefault: 0
reserveAddress*stringThe reserve contract address of the asset
sodax_get_all_borrowersGet all borrowers across all money market assets with pagination3 params
Get all borrowers across all money market assets with pagination
Parameters* required
formatstringResponse format: 'json' for raw data or 'markdown' for formatted textone of
json · markdowndefault: markdownlimitnumberMaximum number of borrowers to return (1-100)default: 20
offsetnumberNumber of borrowers to skip for paginationdefault: 0
sodax_get_partner_summaryGet volume and activity summary for a specific integration partner by their receiver address3 params
Get volume and activity summary for a specific integration partner by their receiver address
Parameters* required
chainIdstringFilter by chain ID
formatstringResponse format: 'json' for raw data or 'markdown' for formatted textone of
json · markdowndefault: markdownreceiver*stringThe partner receiver address
sodax_get_total_supplyGet SODA token total supply as a plain number1 params
Get SODA token total supply as a plain number
Parameters* required
formatstringResponse format: 'json' for raw data or 'markdown' for formatted textone of
json · markdowndefault: markdownsodax_get_circulating_supplyGet SODA token circulating supply as a plain number1 params
Get SODA token circulating supply as a plain number
Parameters* required
formatstringResponse format: 'json' for raw data or 'markdown' for formatted textone of
json · markdowndefault: markdownsodax_refresh_cacheClear 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.
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.
No parameters. Call it with no arguments.
sodax_get_solver_oracleGet 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 serv...3 params
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 serv...
Parameters* required
chainIdstringFilter results to a single intent-relay chain ID (decimal string, e.g. '146' for Sonic). Call sodax_get_relay_chain_id_map to translate.
formatstringResponse format: 'json' for raw data or 'markdown' for formatted textone of
json · markdowndefault: markdownsymbolstringFilter by token symbol (case-insensitive exact match, e.g. 'SODA', 'bnUSD')
sodax_get_solver_quoteGet 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='0xae...5 params
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='0xae...
Parameters* required
amount*stringREQUIRED: 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...
formatstringResponse format: 'json' for raw data or 'markdown' for formatted textone of
json · markdowndefault: markdownquoteTypestring'exact_input' (default): given input amount, quote output amount. 'exact_output': given output amount, quote input amount required.one of
exact_input · exact_outputdefault: exact_inputtokenDst*stringREQUIRED: 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 0xaeafa26e43f46cd83efe89b1e57c858eb568...
tokenSrc*stringREQUIRED: 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 0x...
sodax_relay_submit_txSubmit 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` ar...4 params
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` ar...
Parameters* required
chainId*stringREQUIRED: 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.
dataobjectRequired only for split-tx chains (Solana, Bitcoin). Omit for EVM chains.
formatstringResponse format: 'json' for raw data or 'markdown' for formatted textone of
json · markdowndefault: markdowntxHash*stringREQUIRED: The confirmed transaction hash on the source chain
sodax_relay_get_transaction_packetsList 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.3 params
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* required
chainId*stringREQUIRED: 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.
formatstringResponse format: 'json' for raw data or 'markdown' for formatted textone of
json · markdowndefault: markdowntxHash*stringREQUIRED: The source-chain transaction hash whose packets you want to inspect
sodax_relay_get_packetFetch 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.4 params
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* required
chainId*stringREQUIRED: Intent-relay chain ID of the source chain (decimal string)
connSnstringREQUIRED: 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` fi...
formatstringResponse format: 'json' for raw data or 'markdown' for formatted textone of
json · markdowndefault: markdowntxHash*stringREQUIRED: The source-chain transaction hash
docs_healthCheck SDK documentation availability. Call this first if docs tools seem unavailable.
Check SDK documentation availability. Call this first if docs tools seem unavailable.
No parameters. Call it with no arguments.
docs_refreshReconnect to SDK documentation and refresh available tools. Use if docs seem stale or unavailable.
Reconnect to SDK documentation and refresh available tools. Use if docs seem stale or unavailable.
No parameters. Call it with no arguments.
docs_list_toolsList all SDK documentation tools with parameters. Essential for discovering what's available.
List all SDK documentation tools with parameters. Essential for discovering what's available.
No parameters. Call it with no arguments.
Sponsors
Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthly
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any language
Agent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any languageReadme
SODAX Builders MCP Server
Install from your preferred MCP directory
SODAX MCP server for AI coding assistants. Access live cross-network (cross-chain) API data: swap tokens across 20+ networks, query money market rates, look up solver volume, and search intent history. Includes full cross-chain SDK documentation that auto-syncs from SODAX developer docs. Build cross-network DeFi integrations with real-time protocol data directly in your development workflow. With a SODAX API key, it also quotes and tracks swaps that the user's own wallet signs.
Details
- Repository
- github.com/gosodax/builders-sodax-mcp-server
- Categories
- Monitoring & Observability, Data & Analytics, Finance & Commerce
- Transport
- HTTP
- Registry
- MCP registry, active
- Tools verified
- Nov 6, 2026
