About gosodax/builders-sodax-mcp-server
gosodax/builders-sodax-mcp-server is an MCP server published by gosodax in the Developer Tools category: get instant access to SODAX API data plus SDK documentation. It has been installed 14 times through Conduid.
The repository has 7 stars and 0 forks, with the last commit 6 months ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues (0) before depending on it in production.
Install
npx builders-sodax-mcp-serverThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
Ask AI about gosodax/builders-sodax-mcp-server
Powered by Claude · Grounded in docs
Security checks
- ·README presentNot checked yet.
- ·License declaredNot checked yet.
- ·Tests presentNot checked yet.
- ·Dependencies pinnedNot checked yet.
- ·No dynamic code executionNot checked yet.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
Releases
README
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"
}
}
}
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 (6 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 |
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"
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
Environments
The server runs in two Coolify environments on the tech-team infrastructure (clf.sodax.com):
| Environment | URL | Tracks branch |
|---|---|---|
| Production | https://builders.sodax.com | master |
| Staging | https://test-builders-mcp.coolify.iconblockchain.xyz | development |
Promotion flow:
- Feature branches → PR into
development→ auto-deploys to staging on merge. development→ PR intomaster→ 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
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) |
GET /sse |
SSE endpoint (legacy transport) |
POST /messages |
SSE message endpoint |
Related
- SODAX — sodax.com
- SDK Documentation — docs.sodax.com (proxied automatically)
- Marketing MCP Server — For marketing teams:
https://marketing.sodax.com/mcp
License
MIT
README mirrored from the source repository yesterday. The original is authoritative.