SODAX Builders MCP

io.github.gosodax由 GitHub 帳號 gosodax 發布v1.1.0更新於 Oct 27, 2026

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

已驗證Streamable HTTP可網頁執行金融開發者工具資料與分析

概覽

AI 產生的概覽

遠端 MCP 伺服器，提供 SODAX 跨鏈 DeFi 即時資料（兌換、求解器成交量、意圖、借貸市場、AMM）及自動同步的 SDK 文件。

可以做什麼
  • 列出支援的鏈、可兌換代幣、樞紐資產及完整協定設定
  • 查詢交易、意圖、錢包意圖歷史、求解器成交量、訂單簿以及求解器報價或預言機價格
  • 追蹤跨鏈中繼封包，並將已最終確認的來源鏈交易提交到意圖中繼
  • 查詢借貸市場資產、利率、使用者部位、借款人與出借人
  • 讀取 AMM 流動性部位與資金池 OHLCV K 線，以及合作夥伴與 SODA 代幣供給資料
  • 透過代理的文件工具搜尋並閱讀跨鏈 SDK 文件
適用情境
適合在使用 SODAX SDK 建置或除錯跨鏈 DeFi 整合時，於 AI 程式助理中直接取得即時協定資料與文件；也適合不必離開編輯器就能查看意圖、求解器成交量、借貸利率或中繼狀態。
執行需求
需要一個遠端 MCP 端點；未宣告安裝套件或 API 金鑰。將伺服器位址加入用戶端設定，不支援 streamable HTTP 的用戶端可改用舊版 SSE 端點。需要能存取 SODAX 後端、求解器、中繼與文件服務的網路。
安裝前請注意
中繼提交工具會把已確認的來源鏈交易送到意圖中繼以完成跨鏈投遞，會作用於真實鏈上活動。查詢會包含錢包位址與交易雜湊，這些會傳送給 SODAX 與中繼服務。重新整理快取工具會清空後端與求解器快取。資料來自第三方服務，快取約兩分鐘。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 SODAX Builders MCP，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.gosodax%2Fbuilders-mcp/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "sodax-builders": {
      "type": "http",
      "url": "https://builders.sodax.com/mcp"
    }
  }
}

README

SODAX Builders MCP Server

Install from your preferred MCP directory

[Glama]   [MCP Registry]   [mcp.so]

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.

One-liner: SODAX MCP server: live cross-network DeFi API data and auto-updating SDK docs for 20+ networks. Query swaps, lending, solver volume, and intent history from your AI coding assistant.

Quick Start

Add the MCP server URL to your AI coding assistant's configuration:

json
{  "mcpServers": {    "sodax-builders": {      "url": "https://builders.sodax.com/mcp"    }  }}

Works with Claude, Cursor, VS Code, Windsurf, ChatGPT, and other MCP-compatible agents. One connection gives you access to all cross-network API tools and SDK documentation.

SSE Transport (Legacy)

For clients that don't support streamable HTTP (e.g. Gemini CLI), use the SSE endpoint instead:

json
{  "mcpServers": {    "sodax-builders": {      "url": "https://builders.sodax.com/sse"    }  }}

Tools

Network Configuration (9 tools)

ToolDescription
sodax_get_supported_chainsList all blockchain networks supported by SODAX for cross-chain swaps
sodax_check_chain_supportCheck whether SODAX supports a chain by name, ticker, or key (e.g. "Hedera", "HBAR")
sodax_get_swap_tokensGet available tokens for cross-network swapping, optionally filtered by chain
sodax_get_all_configGet full SODAX configuration (chains + tokens) in one call
sodax_get_all_chains_configsDetailed spoke chain configs with contract addresses and RPCs
sodax_get_relay_chain_id_mapChain ID to intent relay chain ID mapping
sodax_get_hub_assetsHub (Sonic) assets representing spoke tokens
sodax_get_money_market_tokensMoney market supported tokens by chain
sodax_get_money_market_reserve_assetsMoney market reserve assets

Intents & Solver (9 tools)

ToolDescription
sodax_get_transactionLook up an intent transaction by hash — status, amounts, and details
sodax_get_intentLook up a specific intent by its intent hash
sodax_get_user_transactionsGet intent/transaction history for a specific wallet address
sodax_get_volumeGet solver volume data (filled intents) with filtering and pagination
sodax_get_volume_statsGet aggregated solver volume statistics
sodax_get_orderbookGet current cross-chain orderbook entries from solver
sodax_get_solver_intentGet solver-side intent details and fill history
sodax_get_solver_oracleGet the solver's oracle prices for every supported (chain, token) pair
sodax_get_solver_quoteGet a swap quote from the solver (exact_input or exact_output)

Intent Relay (3 tools)

ToolDescription
sodax_relay_submit_txSubmit a confirmed spoke-chain tx to the intent relay for cross-chain delivery
sodax_relay_get_transaction_packetsList every cross-chain packet emitted by a source tx
sodax_relay_get_packetFetch a single relay packet by connection serial number

AMM & Liquidity (2 tools)

ToolDescription
sodax_get_amm_positionsGet AMM liquidity provider NFT positions by owner
sodax_get_amm_pool_candlesGet OHLCV candlestick chart data for an AMM pool

Money Market (6 tools)

ToolDescription
sodax_get_money_market_assetsList all lending/borrowing assets and rates
sodax_get_money_market_assetGet detailed info for a specific asset by reserve address
sodax_get_user_positionGet a user's money market position (supply, borrow, health)
sodax_get_asset_borrowersGet borrowers for a specific money market asset
sodax_get_asset_suppliersGet suppliers (lenders) for a specific money market asset
sodax_get_all_borrowersGet all borrowers across all money market assets

Partners & Token (6 tools)

ToolDescription
sodax_get_partnersList SODAX integration partners across networks
sodax_get_partner_summaryGet volume and activity summary for a specific partner
sodax_get_token_supplyGet SODA token supply info (total, circulating, burned)
sodax_get_total_supplyGet SODA total supply as a plain number
sodax_get_circulating_supplyGet SODA circulating supply as a plain number
sodax_refresh_cacheClear cached data to get fresh results

Cross-Chain SDK Documentation (dynamic)

Tools prefixed with docs_ are automatically proxied from the SODAX docs MCP at docs.sodax.com. They update automatically when documentation changes — no manual sync needed.

ToolDescription
docs_search_sodax_docsSearch cross-chain SDK docs, integration guides, and code examples
docs_query_docs_filesystem_sodax_docsRead a full documentation page from the docs filesystem
docs_list_toolsList all available documentation tools
docs_healthCheck SDK docs MCP connection status
docs_refreshRefresh the tools list from the docs MCP

Example Prompts

Once connected, try asking your AI coding assistant:

Cross-Network Swaps & Tokens

  • "What networks does SODAX support for cross-chain swaps?"
  • "Get available swap tokens across chains on Base"
  • "How do I integrate cross-chain swaps with the SODAX SDK?"

Solver Volume & Intent History

  • "Show me cross-network solver volume for today"
  • "Look up this intent transaction: 0x..."
  • "Get intent history for this wallet address"
  • "Quote me 100 USDC into SODA on Sonic"
  • "What's the current oracle price the solver has for bnUSD on Avalanche?"

Cross-Chain Relay

  • "Track the relay packets for this source tx: 0x..."
  • "Has packet conn_sn=42 from this tx been executed yet?"

Money Market & Lending

  • "What are the lending rates on SODAX money market?"
  • "Show me borrowing APY rates across assets"
  • "Get my money market position"

SDK Documentation

  • "How do I integrate with the SODAX cross-chain SDK?"
  • "Show me code examples for cross-network token swaps"
  • "What SDK methods are available for intent-based execution?"

Data Sources

SourceTypeCache
SODAX Backend API (api.sodax.com/v1/be)Live cross-network data2 min
SODAX Solver API (api.sodax.com/v1/intent)Oracle prices + swap quotes2 min (oracle); none (quote)
SODAX Intent Relay (xcall-relay.nw.iconblockchain.xyz)Cross-chain packet trackingnone
AggregatorCross-chain swap token data2 min
SODAX Docs MCP (docs.sodax.com)SDK documentationAuto-sync

Local Development

bash
# Install dependenciespnpm install
# Run in development modepnpm dev
# Build for productionpnpm build
# Start production serverpnpm start
# Run the test suite (unit tests for drift-check logic)pnpm test

CI & Local Checks

Every PR into development/master runs .github/workflows/ci.yml, which executes the same four checks you can run locally:

CommandWhat it does
pnpm checkTsType-checks the project with tsc --noEmit (no build output).
pnpm lintRuns Biome (biome check .) over the repo. Add :fix to auto-apply safe fixes.
pnpm buildCompiles TypeScript and copies src/public into dist/.
pnpm testRuns the Vitest suite (currently covers the drift-check logic in src/services/apiDriftCheck.ts).

Git hooks (husky + commitlint + lint-staged)

pnpm install installs the hooks automatically via the prepare script:

  • pre-commit — runs pnpm checkTs, pnpm test, then lint-staged (which runs biome check --write on staged files, applying both formatting and safe lint fixes).
  • commit-msg — runs commitlint against the Conventional Commits spec. Messages like feat: add X pass; bad message is rejected.

To skip the hooks in a one-off emergency:

bash
HUSKY=0 git commit -m "your message"

Don't make a habit of it — CI will still enforce the same checks on the PR.

Environment Variables

The server auto-loads a .env file on startup (via Node's --env-file-if-exists flag — requires Node ≥ 22.9.0). Copy .env.example to .env for local development; if no .env exists, every variable falls back to the default below. In production, Coolify injects these directly into the process environment.

VariableDefaultDescription
PORT3000Server port
TRANSPORThttpTransport mode (http or stdio)
NODE_ENV-Set to production for deployment
LOG_LEVELinfoLog verbosity. One of trace, debug, info, warn, error, fatal.
DISCORD_WEBHOOK_URL-Discord webhook for runtime alerts: server status (start/stop), significant errors (uncaught/unhandled), and API-drift summaries. Empty/unset = silent (staging/local).

Deployment

Environments

The server is deployed via Coolify with a branch-based promotion flow:

Promotion flow:

  1. Feature branches → PR into development → auto-deploys to staging on merge.
  2. development → PR into master → auto-deploys to production on merge.

Hotfixes can branch off master and PR directly into master, then be merged back into development.

Docker

bash
docker build -t builders-sodax-mcp-server .docker run -p 3000:3000 builders-sodax-mcp-server

Docker Compose

bash
docker-compose up -d

Deployment notes

The included nixpacks.toml handles deployment automatically. Set these environment variables:

  • PORT=3000
  • NODE_ENV=production

API Endpoints

EndpointDescription
GET /Landing page
GET /apiServer info and tool list
GET /healthHealth check
POST /mcpMCP endpoint (streamable HTTP)
GET /sseSSE endpoint (legacy transport)
POST /messagesSSE message endpoint

Related

License

MIT

來源：README.md，提交 a26ffc8

工具

37

sodax_get_supported_chains

List all blockchain networks supported by SODAX for cross-chain swaps and DeFi operations

輸入參數format

sodax_get_swap_tokens

Get available tokens for swapping on SODAX, optionally filtered by chain

輸入參數formatchainId

sodax_get_transaction

Look up a specific transaction by its hash to see status, amounts, and details

輸入參數formattxHash必填

sodax_get_user_transactions

Get intent/transaction history for a specific wallet address

輸入參數limitformatoffsettoBlockfromBlockuserAddress必填

sodax_get_volume

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

輸入參數sorttoTslimitsinceuntilcursorformatfromTssolverchainIdtoBlockfromBlock另有 3 個

sodax_get_volume_stats

Get aggregate solver volume stats: the approximate total number of filled-intent records (fill documents, not distinct intents). Cached ~60s upstream.

輸入參數format

sodax_get_orderbook

Get current orderbook entries showing pending/open intents

輸入參數limitformatoffsetcreatordstChainsrcChaininputTokenoutputTokendeadlineAfterdeadlineBeforeexcludeZeroDeadline

sodax_get_money_market_assets

List all assets available for lending and borrowing in the SODAX money market

輸入參數formatchainId

sodax_get_user_position

Get a user's lending and borrowing position in the money market

輸入參數formatuserAddress必填

sodax_get_partners

List all SODAX integration partners including wallets, DEXs, and other protocols

輸入參數formatchainId

sodax_get_token_supply

Get SODA token supply information including total, circulating, and burned amounts

輸入參數format

sodax_get_all_config

Get full SODAX configuration including all supported chains, swap tokens, and protocol settings in one call

輸入參數format

sodax_get_relay_chain_id_map

Get mapping between chain IDs and intent relay chain IDs used by the SODAX relay network

輸入參數format

sodax_get_all_chains_configs

Get detailed configuration for all spoke chains including contract addresses, RPCs, and token configs

輸入參數format

sodax_get_hub_assets

Get assets representing spoke tokens on the hub (Sonic) chain, optionally filtered by source chain

輸入參數formatchainId

sodax_get_money_market_tokens

Get tokens supported for money market lending/borrowing, optionally filtered by chain

輸入參數formatchainId

sodax_get_money_market_reserve_assets

Get money market reserve assets used as collateral backing

輸入參數format

sodax_get_amm_positions

Get AMM liquidity provider NFT positions, optionally filtered by owner address

輸入參數limitownerformatoffset

sodax_get_amm_pool_candles

Get OHLCV candlestick chart data for an AMM pool

輸入參數to必填from必填formatpoolId必填chainId必填interval必填

sodax_get_intent

Look up a specific intent by its intent hash (different from transaction hash)

輸入參數formatintentHash必填

sodax_get_solver_intent

Get solver-side details for an intent including fill history. Use includeAll to see all solver documents.

輸入參數formatincludeAllintentHash必填

sodax_get_money_market_asset

Get detailed information for a specific money market asset by its reserve address

輸入參數formatreserveAddress必填

sodax_get_asset_borrowers

Get borrowers for a specific money market asset by its reserve address

輸入參數limitformatoffsetreserveAddress必填

sodax_get_asset_suppliers

Get suppliers (lenders) for a specific money market asset by its reserve address

輸入參數limitformatoffsetreserveAddress必填

sodax_get_all_borrowers

Get all borrowers across all money market assets with pagination

輸入參數limitformatoffset

sodax_get_partner_summary

Get volume and activity summary for a specific integration partner by their receiver address

輸入參數formatchainIdreceiver必填

sodax_get_total_supply

Get SODA token total supply as a plain number

輸入參數format

sodax_get_circulating_supply

Get SODA token circulating supply as a plain number

輸入參數format

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_get_solver_oracle

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.

輸入參數formatsymbolchainId

sodax_get_solver_quote

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.

輸入參數amount必填formattokenDst必填tokenSrc必填quoteType

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.

輸入參數dataformattxHash必填chainId必填

sodax_relay_get_transaction_packets

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.

輸入參數formattxHash必填chainId必填

sodax_relay_get_packet

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.

輸入參數connSnformattxHash必填chainId必填

docs_health

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

無需輸入參數。

docs_refresh

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

無需輸入參數。

docs_list_tools

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

無需輸入參數。

版本歷史

1
  1. v1.1.0最新Sep 16, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分