What can you do with this server?

SODAX Builders MCP is a cross-chain DeFi API server that gives AI coding assistants live blockchain data and auto-updating SDK documentation across 17+ networks. Cross-Network Swap & Chain Data: * List all supported blockchain networks for cross-chain swaps (sodax_get_supported_chains) * Retrieve available swap tokens, optionally filtered by chain (sodax_get_swap_tokens) * Look up a specific intent transaction by hash to check its status and details (sodax_get_transaction) * Fetch intent/transaction history for any wallet address (sodax_get_user_transactions) * Query solver volume data (filled intents) with filtering by chain, solver, block range, or time range (sodax_get_volume) * View the current cross-chain orderbook of pending/open intents (sodax_get_orderbook) DeFi & Token Data: * List all money market lending/borrowing assets and their rates (sodax_get_money_market_assets) * Get a specific user's money market position including supply, borrow, and health factor (sodax_get_user_position) * List all SODAX integration partners (wallets, DEXs, protocols) (sodax_get_partners) * Get SODA token supply info including circulating, total, and burned amounts (sodax_get_token_supply) * Refresh the server's API data cache to force fresh results (sodax_refresh_cache) Cross-Chain SDK Documentation (auto-synced from docs.sodax.com): * Search SDK documentation, integration guides, and code examples (docs_searchDocumentation) * List all available documentation tools (docs_list_tools) * Check the GitBook MCP documentation connection health (docs_health) * Refresh the documentation tools list from GitBook (docs_refresh)

Which integrations are available for this server?

Provides automated access to searchable cross-chain SDK documentation, integration guides, and code examples directly from GitBook to assist with developer workflows.

de en es ja ko ru zh

SODAX Builders MCP

by gosodax

Overview Schema Related Servers Score Discussions(1)

TypeScript

Remote

SODAX Builders MCP Server

SODAX MCP server for AI coding assistants. Access live cross-network (cross-chain) API data: swap tokens across 17+ 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 17+ 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:

{
  "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:

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

Related MCP server: 1inch Cross-Chain Swap MCP Server

Tools

Network Configuration (8 tools)

Tool	Description
`sodax_get_supported_chains`	List all blockchain networks supported by SODAX for cross-chain swaps
`sodax_get_swap_tokens`	Get available tokens for cross-network swapping, optionally filtered by chain
`sodax_get_all_config`	Get full SODAX configuration (chains + tokens) in one call
`sodax_get_all_chains_configs`	Detailed spoke chain configs with contract addresses and RPCs
`sodax_get_relay_chain_id_map`	Chain ID to intent relay chain ID mapping
`sodax_get_hub_assets`	Hub (Sonic) assets representing spoke tokens
`sodax_get_money_market_tokens`	Money market supported tokens by chain
`sodax_get_money_market_reserve_assets`	Money market reserve assets

Intents & Solver (8 tools)

Tool	Description
`sodax_get_transaction`	Look up an intent transaction by hash — status, amounts, and details
`sodax_get_intent`	Look up a specific intent by its intent hash
`sodax_get_user_transactions`	Get intent/transaction history for a specific wallet address
`sodax_get_volume`	Get solver volume data (filled intents) with filtering and pagination
`sodax_get_orderbook`	Get current cross-chain orderbook entries from solver
`sodax_get_solver_intent`	Get solver-side intent details and fill history
`sodax_get_solver_oracle`	Get the solver's oracle prices for every supported (chain, token) pair
`sodax_get_solver_quote`	Get a swap quote from the solver (exact_input or exact_output)

Intent Relay (3 tools)

Tool	Description
`sodax_relay_submit_tx`	Submit a confirmed spoke-chain tx to the intent relay for cross-chain delivery
`sodax_relay_get_transaction_packets`	List every cross-chain packet emitted by a source tx
`sodax_relay_get_packet`	Fetch a single relay packet by connection serial number

AMM & Liquidity (2 tools)

Tool	Description
`sodax_get_amm_positions`	Get AMM liquidity provider NFT positions by owner
`sodax_get_amm_pool_candles`	Get OHLCV candlestick chart data for an AMM pool

Money Market (6 tools)

Tool	Description
`sodax_get_money_market_assets`	List all lending/borrowing assets and rates
`sodax_get_money_market_asset`	Get detailed info for a specific asset by reserve address
`sodax_get_user_position`	Get a user's money market position (supply, borrow, health)
`sodax_get_asset_borrowers`	Get borrowers for a specific money market asset
`sodax_get_asset_suppliers`	Get suppliers (lenders) for a specific money market asset
`sodax_get_all_borrowers`	Get all borrowers across all money market assets

Partners & Token (6 tools)

Tool	Description
`sodax_get_partners`	List SODAX integration partners across networks
`sodax_get_partner_summary`	Get volume and activity summary for a specific partner
`sodax_get_token_supply`	Get SODA token supply info (total, circulating, burned)
`sodax_get_total_supply`	Get SODA total supply as a plain number
`sodax_get_circulating_supply`	Get SODA circulating supply as a plain number
`sodax_refresh_cache`	Clear cached data to get fresh results

Cross-Chain SDK Documentation (dynamic)

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

Tool	Description
`docs_searchDocumentation`	Search cross-chain SDK docs, integration guides, and code examples
`docs_list_tools`	List all available documentation tools
`docs_health`	Check GitBook MCP connection status
`docs_refresh`	Refresh the tools list from GitBook

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

Source	Type	Cache
SODAX Backend API (api.sodax.com/v1/be)	Live cross-network data	2 min
SODAX Solver API (api.sodax.com/v1/intent)	Oracle prices + swap quotes	2 min (oracle); none (quote)
SODAX Intent Relay (xcall-relay.nw.iconblockchain.xyz)	Cross-chain packet tracking	none
Aggregator	Cross-chain swap token data	2 min
GitBook (docs.sodax.com)	SDK documentation	Auto-sync

Local Development

# Install dependencies
pnpm install

# Run in development mode
pnpm dev

# Build for production
pnpm build

# Start production server
pnpm 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:

Command	What it does
`pnpm checkTs`	Type-checks the project with `tsc --noEmit` (no build output).
`pnpm lint`	Runs Biome (`biome check .`) over the repo. Add `:fix` to auto-apply safe fixes.
`pnpm build`	Compiles TypeScript and copies `src/public` into `dist/`.
`pnpm test`	Runs 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:

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

Variable	Default	Description
`PORT`	`3000`	Server port
`TRANSPORT`	`http`	Transport mode (`http` or `stdio`)
`NODE_ENV`	-	Set to `production` for deployment
`LOG_LEVEL`	`info`	Log verbosity. One of `trace`, `debug`, `info`, `warn`, `error`, `fatal`.

Deployment

Environments

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

Production — tracks master, serves https://builders.sodax.com
Staging — tracks development (internal-only)

Promotion flow:

Feature branches → PR into development → auto-deploys to staging on merge.
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

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

Docker Compose

docker-compose up -d

Deployment notes

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

PORT=3000
NODE_ENV=production

API Endpoints

Endpoint	Description
`GET /`	Landing page
`GET /api`	Server info and tool list
`GET /health`	Health check
`POST /mcp`	MCP endpoint (streamable HTTP)
`GET /sse`	SSE endpoint (legacy transport)
`POST /messages`	SSE message endpoint

SODAX — sodax.com
SDK Documentation — docs.sodax.com (proxied automatically)

License

MIT

Install Server

license - permissive license

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

<1hResponse time

3wRelease cycle

5Releases (12mo)

Commit activity

Issues opened vs closed

Resources

Need Help?

Reddit Discussion

Related Servers

Tools

View all tools

Latest Blog Posts

Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
open source
OpenAI
Tool Definition Quality Score (TDQS)
By punkpeye on April 3, 2026.
mcp
The Hackers Who Tracked My Sleep Cycle
By punkpeye on March 26, 2026.
security

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