io.github.gosodax/builders-mcp
Live SODAX API data and SDK docs β chains, tokens, swaps, volume, and more.
Ask AI about io.github.gosodax/builders-mcp
Powered by Claude Β· Grounded in docs
I know everything about io.github.gosodax/builders-mcp. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
SODAX Builders MCP Server
Install from your preferred MCP directory
Β
Β
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=3000NODE_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
