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

View on GitHub

Install

From registry metadata

$ npx add-mcp https://builders.sodax.com/mcp --name builders-mcp

Run 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/mcp

Run in your terminal. Add --scope user to make it available in every project.

Tools

Verified live · 37 tools

Verified 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

formatstring

Response format: 'json' for raw data or 'markdown' for formatted textone of json · markdowndefault: markdown

sodax_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

chainIdstring

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.

formatstring

Response format: 'json' for raw data or 'markdown' for formatted textone of json · markdowndefault: markdown

sodax_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

formatstring

Response format: 'json' for raw data or 'markdown' for formatted textone of json · markdowndefault: markdown

txHash*string

The 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

formatstring

Response format: 'json' for raw data or 'markdown' for formatted textone of json · markdowndefault: markdown

fromBlocknumber

Inclusive lower bound on blockNumber (chain-native ordering)

limitnumber

Maximum number of transactions to return (1-100)default: 20

offsetnumber

Number of transactions to skip for paginationdefault: 0

toBlocknumber

Inclusive upper bound on blockNumber (chain-native ordering)

userAddress*string

The 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

chainIdnumber

Filter by chain ID (e.g., 146 for Sonic)

cursorstring

Pagination cursor from previous response's nextCursor

formatstring

Response format: 'json' for raw data or 'markdown' for formatted textone of json · markdowndefault: markdown

fromBlocknumber

Start block number (don't mix with since/until)

fromTsnumber

Start timestamp (unix seconds). Don't mix with since/until or fromBlock/toBlock.

includeDataboolean

Include raw intent data in responsedefault: false

inputToken*string

REQUIRED: Input token address

limitnumber

Maximum number of filled intents to return (1-100)default: 50

outputToken*string

REQUIRED: Output token address

sincestring

Start time ISO format (don't mix with fromBlock/toBlock or fromTs/toTs)

solverstring

Filter by solver address (0x0...0 for default solver)

sortstring

Sort order by block numberone of asc · descdefault: desc

toBlocknumber

End block number (don't mix with since/until)

toTsnumber

End timestamp (unix seconds). Don't mix with since/until or fromBlock/toBlock.

untilstring

End 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

formatstring

Response format: 'json' for raw data or 'markdown' for formatted textone of json · markdowndefault: markdown

sodax_get_orderbookGet current orderbook entries showing pending/open intents11 params

Get current orderbook entries showing pending/open intents

Parameters* required

creatorstring

Filter by creator address

deadlineAfternumber

Only return intents with deadline > value (Unix seconds)

deadlineBeforenumber

Only return intents with deadline < value (Unix seconds)

dstChainnumber

Filter by destination chain id

excludeZeroDeadlineboolean

Exclude intents where deadline = 0

formatstring

Response format: 'json' for raw data or 'markdown' for formatted textone of json · markdowndefault: markdown

inputTokenstring

Filter by input token address

limitnumber

Max results (default server-side, cap 500)

offsetnumber

Offset for simple pagination

outputTokenstring

Filter by output token address

srcChainnumber

Filter 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

chainIdstring

Filter by chain ID

formatstring

Response format: 'json' for raw data or 'markdown' for formatted textone of json · markdowndefault: markdown

sodax_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

formatstring

Response format: 'json' for raw data or 'markdown' for formatted textone of json · markdowndefault: markdown

userAddress*string

The 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

chainIdinteger

Filter partners by numeric chain ID (e.g. 146 for Sonic)

formatstring

Response format: 'json' for raw data or 'markdown' for formatted textone of json · markdowndefault: markdown

sodax_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

formatstring

Response format: 'json' for raw data or 'markdown' for formatted textone of json · markdowndefault: markdown

sodax_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

formatstring

Response format: 'json' for raw data or 'markdown' for formatted textone of json · markdowndefault: markdown

sodax_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

formatstring

Response format: 'json' for raw data or 'markdown' for formatted textone of json · markdowndefault: markdown

sodax_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

formatstring

Response format: 'json' for raw data or 'markdown' for formatted textone of json · markdowndefault: markdown

sodax_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

chainIdstring

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.

formatstring

Response format: 'json' for raw data or 'markdown' for formatted textone of json · markdowndefault: markdown

sodax_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

chainIdstring

Filter by chain ID

formatstring

Response format: 'json' for raw data or 'markdown' for formatted textone of json · markdowndefault: markdown

sodax_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

formatstring

Response format: 'json' for raw data or 'markdown' for formatted textone of json · markdowndefault: markdown

sodax_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

formatstring

Response format: 'json' for raw data or 'markdown' for formatted textone of json · markdowndefault: markdown

limitnumber

Maximum number of positions to return

offsetnumber

Number of positions to skip for pagination

ownerstring

Filter 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*string

Chain ID where the pool is deployed (e.g., 'sonic')

formatstring

Response format: 'json' for raw data or 'markdown' for formatted textone of json · markdowndefault: markdown

from*number

REQUIRED: Start timestamp (unix seconds)

interval*string

REQUIRED: Candle intervalone of 1m · 5m · 15m · 1h · 4h · 1d

poolId*string

The pool contract address or ID

to*number

REQUIRED: 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

formatstring

Response format: 'json' for raw data or 'markdown' for formatted textone of json · markdowndefault: markdown

intentHash*string

The 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

formatstring

Response format: 'json' for raw data or 'markdown' for formatted textone of json · markdowndefault: markdown

includeAllboolean

Include all intent documents (history) instead of just the latestdefault: false

intentHash*string

The 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

formatstring

Response format: 'json' for raw data or 'markdown' for formatted textone of json · markdowndefault: markdown

reserveAddress*string

The 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

formatstring

Response format: 'json' for raw data or 'markdown' for formatted textone of json · markdowndefault: markdown

limitnumber

Maximum number of borrowers to return (1-100)default: 20

offsetnumber

Number of borrowers to skip for paginationdefault: 0

reserveAddress*string

The 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

formatstring

Response format: 'json' for raw data or 'markdown' for formatted textone of json · markdowndefault: markdown

limitnumber

Maximum number of suppliers to return (1-100)default: 20

offsetnumber

Number of suppliers to skip for paginationdefault: 0

reserveAddress*string

The 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

formatstring

Response format: 'json' for raw data or 'markdown' for formatted textone of json · markdowndefault: markdown

limitnumber

Maximum number of borrowers to return (1-100)default: 20

offsetnumber

Number 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

chainIdstring

Filter by chain ID

formatstring

Response format: 'json' for raw data or 'markdown' for formatted textone of json · markdowndefault: markdown

receiver*string

The 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

formatstring

Response format: 'json' for raw data or 'markdown' for formatted textone of json · markdowndefault: markdown

sodax_get_circulating_supplyGet SODA token circulating supply as a plain number1 params

Get SODA token circulating supply as a plain number

Parameters* required

formatstring

Response format: 'json' for raw data or 'markdown' for formatted textone of json · markdowndefault: markdown

sodax_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

chainIdstring

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.

formatstring

Response format: 'json' for raw data or 'markdown' for formatted textone of json · markdowndefault: markdown

symbolstring

Filter 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*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...

formatstring

Response format: 'json' for raw data or 'markdown' for formatted textone of json · markdowndefault: markdown

quoteTypestring

'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_input

tokenDst*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 0xaeafa26e43f46cd83efe89b1e57c858eb568...

tokenSrc*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 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*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.

dataobject

Required only for split-tx chains (Solana, Bitcoin). Omit for EVM chains.

formatstring

Response format: 'json' for raw data or 'markdown' for formatted textone of json · markdowndefault: markdown

txHash*string

REQUIRED: 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*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.

formatstring

Response format: 'json' for raw data or 'markdown' for formatted textone of json · markdowndefault: markdown

txHash*string

REQUIRED: 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*string

REQUIRED: Intent-relay chain ID of the source chain (decimal string)

connSnstring

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` fi...

formatstring

Response format: 'json' for raw data or 'markdown' for formatted textone of json · markdowndefault: markdown

txHash*string

REQUIRED: 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.

Readme

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.

View the full README on GitHub

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

Related Monitoring & Observability MCP servers

View all

LLM Optimizerjonradoff/llmoptAI brand visibility analytics: visibility scores, optimizations, video, Reddit, and search rankings.7stars

PostFastpeturgeorgievv-factory/postfast-mcpSchedule posts on 11 social networks, answer comments and read analytics, hosted or local7stars

Salesforce Cloudaaronsb/salesforce-cloudAI-powered Salesforce CRM: opportunity intelligence, conversation analysis, SOQL, analytics6stars

Convalyticsdan-cleary/convalyticsRead-only analytics for Convex apps, queryable via MCP from Claude, Cursor, and other clients.6stars

Indigo Mcpindigoprotocol/indigo-mcpIndigo Protocol MCP — iAsset prices, CDP analytics, stability pools, staking & governance6stars

SocialGPTscrollmark/socialgpt-mcpSocial media analytics, video analysis, and competitor intel for any MCP-compatible AI agent.6stars