SODAX Builders MCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PORT | No | Server port | 3000 |
| NODE_ENV | No | Set to production for deployment | |
| TRANSPORT | No | Transport mode (http or stdio) | stdio |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| sodax_get_supported_chainsA | List all blockchain networks supported by SODAX for cross-chain swaps and DeFi operations |
| sodax_get_swap_tokensB | Get available tokens for swapping on SODAX, optionally filtered by chain |
| sodax_get_transactionA | Look up a specific transaction by its hash to see status, amounts, and details |
| sodax_get_user_transactionsA | Get intent/transaction history for a specific wallet address |
| sodax_get_volumeA | 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). |
| sodax_get_volume_statsA | Get aggregate solver volume stats: the approximate total number of filled-intent records (fill documents, not distinct intents). Cached ~60s upstream. |
| sodax_get_orderbookB | Get current orderbook entries showing pending/open intents |
| sodax_get_money_market_assetsB | List all assets available for lending and borrowing in the SODAX money market |
| sodax_get_user_positionA | Get a user's lending and borrowing position in the money market |
| sodax_get_partnersA | List all SODAX integration partners including wallets, DEXs, and other protocols |
| sodax_get_token_supplyA | Get SODA token supply information including total, circulating, and burned amounts |
| sodax_get_all_configA | Get full SODAX configuration including all supported chains, swap tokens, and protocol settings in one call |
| sodax_get_relay_chain_id_mapB | Get mapping between chain IDs and intent relay chain IDs used by the SODAX relay network |
| sodax_get_all_chains_configsB | Get detailed configuration for all spoke chains including contract addresses, RPCs, and token configs |
| sodax_get_hub_assetsA | Get assets representing spoke tokens on the hub (Sonic) chain, optionally filtered by source chain |
| sodax_get_money_market_tokensA | Get tokens supported for money market lending/borrowing, optionally filtered by chain |
| sodax_get_money_market_reserve_assetsB | Get money market reserve assets used as collateral backing |
| sodax_get_amm_positionsA | Get AMM liquidity provider NFT positions, optionally filtered by owner address |
| sodax_get_amm_pool_candlesB | Get OHLCV candlestick chart data for an AMM pool |
| sodax_get_intentA | Look up a specific intent by its intent hash (different from transaction hash) |
| sodax_get_solver_intentA | Get solver-side details for an intent including fill history. Use includeAll to see all solver documents. |
| sodax_get_money_market_assetA | Get detailed information for a specific money market asset by its reserve address |
| sodax_get_asset_borrowersA | Get borrowers for a specific money market asset by its reserve address |
| sodax_get_asset_suppliersA | Get suppliers (lenders) for a specific money market asset by its reserve address |
| sodax_get_all_borrowersA | Get all borrowers across all money market assets with pagination |
| sodax_get_partner_summaryA | Get volume and activity summary for a specific integration partner by their receiver address |
| sodax_get_total_supplyA | Get SODA token total supply as a plain number |
| sodax_get_circulating_supplyB | Get SODA token circulating supply as a plain number |
| sodax_refresh_cacheA | 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. |
| sodax_get_solver_oracleA | 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. |
| sodax_get_solver_quoteA | 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. |
| sodax_relay_submit_txA | 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 |
| sodax_relay_get_transaction_packetsA | 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. |
| sodax_relay_get_packetA | Fetch a single relay packet by its connection serial number (conn_sn). Returns the packet data on success or a |
| docs_healthA | Check SDK documentation availability. Call this first if docs tools seem unavailable. |
| docs_refreshA | Reconnect to SDK documentation and refresh available tools. Use if docs seem stale or unavailable. |
| docs_list_toolsA | List all SDK documentation tools with parameters. Essential for discovering what's available. |
| docs_searchDocumentationA | [SDK Docs] Search across the documentation to find relevant information, code examples, API references, and guides. Use this tool when you need to answer questions about Docs, find specific documentation, understand how features work, or locate implementation details. The search returns contextual content with titles and direct links to the documentation pages. |
| docs_getPageA | [SDK Docs] Fetch the full markdown content of a specific documentation page from Docs. Use this when you have a page URL and want to read its content. Accepts full URLs (e.g. https://docs.sodax.com//getting-started). Since |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Latest Blog Posts
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/gosodax/builders-sodax-mcp-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server