protogrid

Search / io.github.gosodax/builders-mcp

SODAX Builders MCP

R0· no sign-in

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

v1.1.0 · active · repository · descriptor JSON · versions

An agent can connect right now, no human step.Remote endpoint, no authentication, reachable on the last probe.
Quality80good
Trust82of 100
Uptime, 30 days94%
Latency p501184 ms

Connect

8 clients · secrets stay placeholders
{
  "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

Quality 80 / 100good

protocol75 · weight 25
  • warn
    protocol.modernnewest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
  • n/a
    protocol.statelessonly applies to 2026-07-28 servers
  • pass
    protocol.transportstreamable HTTP
  • n/a
    protocol.list_ttlonly applies to 2026-07-28 servers
authorizationn/a · weight 15
  • n/a
    auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
  • n/a
    auth.secret_in_urlno templated URL
tool hygiene86 · weight 30
  • pass
    tools.descriptionsevery tool has a description
  • warn
    tools.description_length1 tools have descriptions over 1,024 characters, which crowds the context
  • pass
    tools.schemasevery tool has an object input schema
  • pass
    tools.annotations37 of 37 tools declare readOnlyHint or destructiveHint
  • warn
    tools.directory_hints1 of 37 tools declare all four hints; missing: sodax_get_swap_tokens (idempotentHint); sodax_get_user_transactions (idempotentHint); sodax_get_orderbook (idempotentHint); …
  • pass
    tools.token_costabout 6,883 tokens to load every tool
  • pass
    tools.api_dumptools are not a one-to-one API dump
stability75 · weight 15
  • warn
    stability.changes74 tool changes in 30 days
  • pass
    stability.rug_pullno tool changed its meaning under the same name
dependenciesn/a · weight 15
  • n/a
    deps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI package

37 tools, about 6,883 tokens to load them all · tool set 09dad95ea63f · tools last changed 2026-10-12 · checked 2026-10-20 03:05 UTC

Tool changes

  • docs_list_toolsadded

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

  • docs_refreshadded

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

  • docs_healthadded

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

  • sodax_relay_get_packetadded

    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_packetsadded

    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_txadded

    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.

  • sodax_get_solver_quoteadded

    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_solver_oracleadded

    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_refresh_cacheadded

    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_circulating_supplyadded

    Get 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.

Trust 82 / 100

provenance80
liveness98
freshness45
hygiene100

+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.

Endpoints

remoteauthreachableuptime 30dp50protocollast ok
https://builders.sodax.com/mcp streamable-httpnoneyes94%1184 ms2025-11-252026-10-20

Tools (37)

docs_healthread-onlyCheck SDK documentation availability. Call this first if docs tools seem unavailable.
docs_list_toolsread-onlyList all SDK documentation tools with parameters. Essential for discovering what's available.
docs_refreshReconnect to SDK documentation and refresh available tools. Use if docs seem stale or unavailable.
sodax_get_all_borrowersread-onlyGet all borrowers across all money market assets with pagination
sodax_get_all_chains_configsread-onlyGet detailed configuration for all spoke chains including contract addresses, RPCs, and token configs
sodax_get_all_configread-onlyGet full SODAX configuration including all supported chains, swap tokens, and protocol settings in one call
sodax_get_amm_pool_candlesread-onlyGet OHLCV candlestick chart data for an AMM pool
sodax_get_amm_positionsread-onlyGet AMM liquidity provider NFT positions, optionally filtered by owner address
sodax_get_asset_borrowersread-onlyGet borrowers for a specific money market asset by its reserve address
sodax_get_asset_suppliersread-onlyGet suppliers (lenders) for a specific money market asset by its reserve address
sodax_get_circulating_supplyread-onlyGet SODA token circulating supply as a plain number
sodax_get_hub_assetsread-onlyGet assets representing spoke tokens on the hub (Sonic) chain, optionally filtered by source chain
sodax_get_intentread-onlyLook up a specific intent by its intent hash (different from transaction hash)
sodax_get_money_market_assetread-onlyGet detailed information for a specific money market asset by its reserve address
sodax_get_money_market_assetsread-onlyList all assets available for lending and borrowing in the SODAX money market
sodax_get_money_market_reserve_assetsread-onlyGet money market reserve assets used as collateral backing
sodax_get_money_market_tokensread-onlyGet tokens supported for money market lending/borrowing, optionally filtered by chain
sodax_get_orderbookread-onlyGet current orderbook entries showing pending/open intents
sodax_get_partnersread-onlyList all SODAX integration partners including wallets, DEXs, and other protocols
sodax_get_partner_summaryread-onlyGet volume and activity summary for a specific integration partner by their receiver address
sodax_get_relay_chain_id_mapread-onlyGet mapping between chain IDs and intent relay chain IDs used by the SODAX relay network
sodax_get_solver_intentread-onlyGet solver-side details for an intent including fill history. Use includeAll to see all solver documents.
sodax_get_solver_oracleread-onlyGet 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-onlyGet 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-onlyList all blockchain networks supported by SODAX for cross-chain swaps and DeFi operations
sodax_get_swap_tokensread-onlyGet available tokens for swapping on SODAX, optionally filtered by chain
sodax_get_token_supplyread-onlyGet SODA token supply information including total, circulating, and burned amounts
sodax_get_total_supplyread-onlyGet SODA token total supply as a plain number
sodax_get_transactionread-onlyLook up a specific transaction by its hash to see status, amounts, and details
sodax_get_user_positionread-onlyGet a user's lending and borrowing position in the money market
sodax_get_user_transactionsread-onlyGet intent/transaction history for a specific wallet address
sodax_get_volumeread-onlyGet 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-onlyGet aggregate solver volume stats: the approximate total number of filled-intent records (fill documents, not distinct intents). Cached ~60s upstream.
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.
sodax_relay_get_packetread-onlyFetch 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-onlyList 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_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` argument.

Schemas: list_tools.

Similar MCP servers

Official server.json
{
  "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."
}