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.

Tools

Cross-Network API Data (6 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_transaction | Look up an intent transaction by hash — status, amounts, and details | | 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 |

DeFi & Token Data (5 tools)

| Tool | Description | |------|-------------| | sodax_get_money_market_assets | List lending/borrowing assets and rates in the money market | | sodax_get_user_position | Get a user's money market position (supply, borrow, health) | | sodax_get_partners | List SODAX integration partners across networks | | sodax_get_token_supply | Get SODA token supply info (circulating, total, max) | | 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"

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 API (api.sodax.com) | Live cross-network data | 2 min | | 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

Environment Variables

| Variable | Default | Description | |----------|---------|-------------| | PORT | 3000 | Server port | | TRANSPORT | http | Transport mode (http or stdio) | | NODE_ENV | - | Set to production for deployment |

Deployment

Docker

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

Docker Compose

docker-compose up -d

Railway/Coolify

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

Related

• SODAX — sodax.com
• SDK Documentation — docs.sodax.com (proxied automatically)
• Marketing MCP Server — For marketing teams: https://marketing.sodax.com/mcp

License

MIT