Search / io.github.gosodax/builders-mcp
SODAX Builders MCP
R0· no sign-inCross-network DeFi API data, AMM analytics, and SDK docs for 17+ networks.
v1.1.0 · active · repository · descriptor JSON · versions
Search / io.github.gosodax/builders-mcp
R0· no sign-inCross-network DeFi API data, AMM analytics, and SDK docs for 17+ networks.
v1.1.0 · active · repository · descriptor JSON · versions
{
"mcpServers": {
"builders-mcp": {
"type": "http",
"url": "https://builders.sodax.com/mcp"
}
}
}claude mcp add --transport http builders-mcp https://builders.sodax.com/mcp[mcp_servers.builders-mcp]
url = "https://builders.sodax.com/mcp"
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"builders-mcp": {
"type": "remote",
"url": "https://builders.sodax.com/mcp",
"enabled": true
}
}
}{
"mcpServers": {
"builders-mcp": {
"type": "http",
"url": "https://builders.sodax.com/mcp"
}
},
"deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=builders-mcp&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vYnVpbGRlcnMuc29kYXguY29tL21jcCJ9"
}{
"servers": {
"builders-mcp": {
"type": "http",
"url": "https://builders.sodax.com/mcp"
}
}
}{
"mcpServers": {
"builders-mcp": {
"httpUrl": "https://builders.sodax.com/mcp"
}
}
}extensions:
"builders-mcp":
enabled: true
name: "builders-mcp"
type: streamable_http
uri: "https://builders.sodax.com/mcp"
timeout: 300
protocol.modernnewest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28protocol.statelessonly applies to 2026-07-28 serversprotocol.transportstreamable HTTPprotocol.list_ttlonly applies to 2026-07-28 serversauth.prm, auth.as_metadata, auth.cimdno remote uses OAuthauth.secret_in_urlno templated URLtools.descriptionsevery tool has a descriptiontools.description_length1 tools have descriptions over 1,024 characters, which crowds the contexttools.schemasevery tool has an object input schematools.annotations37 of 37 tools declare readOnlyHint or destructiveHinttools.directory_hints1 of 37 tools declare all four hints; missing: sodax_get_swap_tokens (idempotentHint); sodax_get_user_transactions (idempotentHint); sodax_get_orderbook (idempotentHint); …tools.token_costabout 6,883 tokens to load every tooltools.api_dumptools are not a one-to-one API dumpstability.changes74 tool changes in 30 daysstability.rug_pullno tool changed its meaning under the same namedeps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI packagedocs_list_toolsaddedList all SDK documentation tools with parameters. Essential for discovering what's available.
docs_refreshaddedReconnect to SDK documentation and refresh available tools. Use if docs seem stale or unavailable.
docs_healthaddedCheck SDK documentation availability. Call this first if docs tools seem unavailable.
sodax_relay_get_packetaddedFetch 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.
sodax_relay_get_transaction_packetsaddedList 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_submit_txaddedSubmit 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.
sodax_get_solver_quoteaddedGet 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_get_solver_oracleaddedGet 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_refresh_cacheaddedClear 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_circulating_supplyaddedGet SODA token circulating supply as a plain number
Showing the latest 10. Full history: list_changes · trend: quality JSON.
Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.
+repository +namespace-matches-repo +reachable +uptime-94% -stale-211d
Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.
| remote | auth | reachable | uptime 30d | p50 | protocol | last ok |
|---|---|---|---|---|---|---|
https://builders.sodax.com/mcp streamable-http | none | yes | 94% | 1184 ms | 2025-11-25 | 2026-10-20 |
docs_healthread-only | Check SDK documentation availability. Call this first if docs tools seem unavailable. |
docs_list_toolsread-only | List all SDK documentation tools with parameters. Essential for discovering what's available. |
docs_refresh | Reconnect to SDK documentation and refresh available tools. Use if docs seem stale or unavailable. |
sodax_get_all_borrowersread-only | Get all borrowers across all money market assets with pagination |
sodax_get_all_chains_configsread-only | Get detailed configuration for all spoke chains including contract addresses, RPCs, and token configs |
sodax_get_all_configread-only | Get full SODAX configuration including all supported chains, swap tokens, and protocol settings in one call |
sodax_get_amm_pool_candlesread-only | Get OHLCV candlestick chart data for an AMM pool |
sodax_get_amm_positionsread-only | Get AMM liquidity provider NFT positions, optionally filtered by owner address |
sodax_get_asset_borrowersread-only | Get borrowers for a specific money market asset by its reserve address |
sodax_get_asset_suppliersread-only | Get suppliers (lenders) for a specific money market asset by its reserve address |
sodax_get_circulating_supplyread-only | Get SODA token circulating supply as a plain number |
sodax_get_hub_assetsread-only | Get assets representing spoke tokens on the hub (Sonic) chain, optionally filtered by source chain |
sodax_get_intentread-only | Look up a specific intent by its intent hash (different from transaction hash) |
sodax_get_money_market_assetread-only | Get detailed information for a specific money market asset by its reserve address |
sodax_get_money_market_assetsread-only | List all assets available for lending and borrowing in the SODAX money market |
sodax_get_money_market_reserve_assetsread-only | Get money market reserve assets used as collateral backing |
sodax_get_money_market_tokensread-only | Get tokens supported for money market lending/borrowing, optionally filtered by chain |
sodax_get_orderbookread-only | Get current orderbook entries showing pending/open intents |
sodax_get_partnersread-only | List all SODAX integration partners including wallets, DEXs, and other protocols |
sodax_get_partner_summaryread-only | Get volume and activity summary for a specific integration partner by their receiver address |
sodax_get_relay_chain_id_mapread-only | Get mapping between chain IDs and intent relay chain IDs used by the SODAX relay network |
sodax_get_solver_intentread-only | Get solver-side details for an intent including fill history. Use includeAll to see all solver documents. |
sodax_get_solver_oracleread-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. |
sodax_get_solver_quoteread-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. |
sodax_get_supported_chainsread-only | List all blockchain networks supported by SODAX for cross-chain swaps and DeFi operations |
sodax_get_swap_tokensread-only | Get available tokens for swapping on SODAX, optionally filtered by chain |
sodax_get_token_supplyread-only | Get SODA token supply information including total, circulating, and burned amounts |
sodax_get_total_supplyread-only | Get SODA token total supply as a plain number |
sodax_get_transactionread-only | Look up a specific transaction by its hash to see status, amounts, and details |
sodax_get_user_positionread-only | Get a user's lending and borrowing position in the money market |
sodax_get_user_transactionsread-only | Get intent/transaction history for a specific wallet address |
sodax_get_volumeread-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). |
sodax_get_volume_statsread-only | Get aggregate solver volume stats: the approximate total number of filled-intent records (fill documents, not distinct intents). Cached ~60s upstream. |
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. |
sodax_relay_get_packetread-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. |
sodax_relay_get_transaction_packetsread-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. |
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. |
Schemas: list_tools.
{
"name": "io.github.gosodax/builders-mcp",
"title": "SODAX Builders MCP",
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
"remotes": [
{
"url": "https://builders.sodax.com/mcp",
"type": "streamable-http"
}
],
"version": "1.1.0",
"repository": {
"url": "https://github.com/gosodax/builders-sodax-mcp-server",
"source": "github"
},
"description": "Cross-network DeFi API data, AMM analytics, and SDK docs for 17+ networks."
}