{ "markdown": "# SODAX Builders MCP Server\n\n

\n Install from your preferred MCP directory

\n \"Glama\"\n  \n \"MCP\n  \n \"mcp.so\"\n

\n\nSODAX MCP server for AI coding assistants. Access live cross-network (cross-chain) API data: swap tokens across 19+ 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.\n\n**One-liner:** SODAX MCP server: live cross-network DeFi API data and auto-updating SDK docs for 19+ networks. Query swaps, lending, solver volume, and intent history from your AI coding assistant.\n\n## Quick Start\n\nAdd the MCP server URL to your AI coding assistant's configuration:\n\n```json\n{\n \"mcpServers\": {\n \"sodax-builders\": {\n \"url\": \"https://builders.sodax.com/mcp\"\n }\n }\n}\n```\n\nWorks 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.\n\n### SSE Transport (Legacy)\n\nFor clients that don't support streamable HTTP (e.g. Gemini CLI), use the SSE endpoint instead:\n\n```json\n{\n \"mcpServers\": {\n \"sodax-builders\": {\n \"url\": \"https://builders.sodax.com/sse\"\n }\n }\n}\n```\n\n## Tools\n\n### Network Configuration (8 tools)\n\n| Tool | Description |\n|------|-------------|\n| `sodax_get_supported_chains` | List all blockchain networks supported by SODAX for cross-chain swaps |\n| `sodax_get_swap_tokens` | Get available tokens for cross-network swapping, optionally filtered by chain |\n| `sodax_get_all_config` | Get full SODAX configuration (chains + tokens) in one call |\n| `sodax_get_all_chains_configs` | Detailed spoke chain configs with contract addresses and RPCs |\n| `sodax_get_relay_chain_id_map` | Chain ID to intent relay chain ID mapping |\n| `sodax_get_hub_assets` | Hub (Sonic) assets representing spoke tokens |\n| `sodax_get_money_market_tokens` | Money market supported tokens by chain |\n| `sodax_get_money_market_reserve_assets` | Money market reserve assets |\n\n### Intents & Solver (9 tools)\n\n| Tool | Description |\n|------|-------------|\n| `sodax_get_transaction` | Look up an intent transaction by hash — status, amounts, and details |\n| `sodax_get_intent` | Look up a specific intent by its intent hash |\n| `sodax_get_user_transactions` | Get intent/transaction history for a specific wallet address |\n| `sodax_get_volume` | Get solver volume data (filled intents) with filtering and pagination |\n| `sodax_get_volume_stats` | Get aggregated solver volume statistics |\n| `sodax_get_orderbook` | Get current cross-chain orderbook entries from solver |\n| `sodax_get_solver_intent` | Get solver-side intent details and fill history |\n| `sodax_get_solver_oracle` | Get the solver's oracle prices for every supported (chain, token) pair |\n| `sodax_get_solver_quote` | Get a swap quote from the solver (exact_input or exact_output) |\n\n### Intent Relay (3 tools)\n\n| Tool | Description |\n|------|-------------|\n| `sodax_relay_submit_tx` | Submit a confirmed spoke-chain tx to the intent relay for cross-chain delivery |\n| `sodax_relay_get_transaction_packets` | List every cross-chain packet emitted by a source tx |\n| `sodax_relay_get_packet` | Fetch a single relay packet by connection serial number |\n\n### AMM & Liquidity (2 tools)\n\n| Tool | Description |\n|------|-------------|\n| `sodax_get_amm_positions` | Get AMM liquidity provider NFT positions by owner |\n| `sodax_get_amm_pool_candles` | Get OHLCV candlestick chart data for an AMM pool |\n\n### Money Market (6 tools)\n\n| Tool | Description |\n|------|-------------|\n| `sodax_get_money_market_assets` | List all lending/borrowing assets and rates |\n| `sodax_get_money_market_asset` | Get detailed info for a specific asset by reserve address |\n| `sodax_get_user_position` | Get a user's money market position (supply, borrow, health) |\n| `sodax_get_asset_borrowers` | Get borrowers for a specific money market asset |\n| `sodax_get_asset_suppliers` | Get suppliers (lenders) for a specific money market asset |\n| `sodax_get_all_borrowers` | Get all borrowers across all money market assets |\n\n### Partners & Token (6 tools)\n\n| Tool | Description |\n|------|-------------|\n| `sodax_get_partners` | List SODAX integration partners across networks |\n| `sodax_get_partner_summary` | Get volume and activity summary for a specific partner |\n| `sodax_get_token_supply` | Get SODA token supply info (total, circulating, burned) |\n| `sodax_get_total_supply` | Get SODA total supply as a plain number |\n| `sodax_get_circulating_supply` | Get SODA circulating supply as a plain number |\n| `sodax_refresh_cache` | Clear cached data to get fresh results |\n\n### Cross-Chain SDK Documentation (dynamic)\n\nTools prefixed with `docs_` are automatically proxied from the GitBook MCP at docs.sodax.com. They update automatically when documentation changes — no manual sync needed.\n\n| Tool | Description |\n|------|-------------|\n| `docs_searchDocumentation` | Search cross-chain SDK docs, integration guides, and code examples |\n| `docs_getPage` | Fetch a full documentation page |\n| `docs_list_tools` | List all available documentation tools |\n| `docs_health` | Check GitBook MCP connection status |\n| `docs_refresh` | Refresh the tools list from GitBook |\n\n## Example Prompts\n\nOnce connected, try asking your AI coding assistant:\n\n### Cross-Network Swaps & Tokens\n- *\"What networks does SODAX support for cross-chain swaps?\"*\n- *\"Get available swap tokens across chains on Base\"*\n- *\"How do I integrate cross-chain swaps with the SODAX SDK?\"*\n\n### Solver Volume & Intent History\n- *\"Show me cross-network solver volume for today\"*\n- *\"Look up this intent transaction: 0x...\"*\n- *\"Get intent history for this wallet address\"*\n- *\"Quote me 100 USDC into SODA on Sonic\"*\n- *\"What's the current oracle price the solver has for bnUSD on Avalanche?\"*\n\n### Cross-Chain Relay\n- *\"Track the relay packets for this source tx: 0x...\"*\n- *\"Has packet conn_sn=42 from this tx been executed yet?\"*\n\n### Money Market & Lending\n- *\"What are the lending rates on SODAX money market?\"*\n- *\"Show me borrowing APY rates across assets\"*\n- *\"Get my money market position\"*\n\n### SDK Documentation\n- *\"How do I integrate with the SODAX cross-chain SDK?\"*\n- *\"Show me code examples for cross-network token swaps\"*\n- *\"What SDK methods are available for intent-based execution?\"*\n\n## Data Sources\n\n| Source | Type | Cache |\n|--------|------|-------|\n| SODAX Backend API (api.sodax.com/v1/be) | Live cross-network data | 2 min |\n| SODAX Solver API (api.sodax.com/v1/intent) | Oracle prices + swap quotes | 2 min (oracle); none (quote) |\n| SODAX Intent Relay (xcall-relay.nw.iconblockchain.xyz) | Cross-chain packet tracking | none |\n| Aggregator | Cross-chain swap token data | 2 min |\n| GitBook (docs.sodax.com) | SDK documentation | Auto-sync |\n\n## Local Development\n\n```bash\n# Install dependencies\npnpm install\n\n# Run in development mode\npnpm dev\n\n# Build for production\npnpm build\n\n# Start production server\npnpm start\n\n# Run the test suite (unit tests for drift-check logic)\npnpm test\n```\n\n## CI & Local Checks\n\nEvery PR into `development`/`master` runs `.github/workflows/ci.yml`, which executes the same four checks you can run locally:\n\n| Command | What it does |\n|---------|--------------|\n| `pnpm checkTs` | Type-checks the project with `tsc --noEmit` (no build output). |\n| `pnpm lint` | Runs Biome (`biome check .`) over the repo. Add `:fix` to auto-apply safe fixes. |\n| `pnpm build` | Compiles TypeScript and copies `src/public` into `dist/`. |\n| `pnpm test` | Runs the Vitest suite (currently covers the drift-check logic in `src/services/apiDriftCheck.ts`). |\n\n### Git hooks (husky + commitlint + lint-staged)\n\n`pnpm install` installs the hooks automatically via the `prepare` script:\n\n- **`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).\n- **`commit-msg`** — runs `commitlint` against the [Conventional Commits](https://www.conventionalcommits.org/) spec. Messages like `feat: add X` pass; `bad message` is rejected.\n\nTo skip the hooks in a one-off emergency:\n\n```bash\nHUSKY=0 git commit -m \"your message\"\n```\n\nDon't make a habit of it — CI will still enforce the same checks on the PR.\n\n### Environment Variables\n\nThe server auto-loads a `.env` file on startup (via Node's `--env-file-if-exists`\nflag — requires Node ≥ 22.9.0). Copy `.env.example` to `.env` for local development;\nif no `.env` exists, every variable falls back to the default below. In production,\nCoolify injects these directly into the process environment.\n\n| Variable | Default | Description |\n|----------|---------|-------------|\n| `PORT` | `3000` | Server port |\n| `TRANSPORT` | `http` | Transport mode (`http` or `stdio`) |\n| `NODE_ENV` | - | Set to `production` for deployment |\n| `LOG_LEVEL` | `info` | Log verbosity. One of `trace`, `debug`, `info`, `warn`, `error`, `fatal`. |\n| `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). |\n\n## Deployment\n\n### Environments\n\nThe server is deployed via Coolify with a branch-based promotion flow:\n\n- **Production** — tracks `master`, serves https://builders.sodax.com\n- **Staging** — tracks `development` (internal-only)\n\nPromotion flow:\n\n1. Feature branches → PR into `development` → auto-deploys to **staging** on merge.\n2. `development` → PR into `master` → auto-deploys to **production** on merge.\n\nHotfixes can branch off `master` and PR directly into `master`, then be merged back into `development`.\n\n### Docker\n\n```bash\ndocker build -t builders-sodax-mcp-server .\ndocker run -p 3000:3000 builders-sodax-mcp-server\n```\n\n### Docker Compose\n\n```bash\ndocker-compose up -d\n```\n\n### Deployment notes\n\nThe included `nixpacks.toml` handles deployment automatically. Set these environment variables:\n- `PORT=3000`\n- `NODE_ENV=production`\n\n## API Endpoints\n\n| Endpoint | Description |\n|----------|-------------|\n| `GET /` | Landing page |\n| `GET /api` | Server info and tool list |\n| `GET /health` | Health check |\n| `POST /mcp` | MCP endpoint (streamable HTTP) |\n| `GET /sse` | SSE endpoint (legacy transport) |\n| `POST /messages` | SSE message endpoint |\n\n## Related\n\n- **SODAX** — [sodax.com](https://sodax.com)\n- **SDK Documentation** — [docs.sodax.com](https://docs.sodax.com) (proxied automatically)\n\n## License\n\nMIT\n", "bytes": 11129, "sha": "a1d5748099d72febcee1fd8dfb6ce23f7e912f70cc91b0e212ab732b42d94cdd", "repo_slug": "gosodax/builders-sodax-mcp-server", "fonte": "repo", "truncated": false, "api": "https://agentalog.com/api/listings/mcp_io_github_gosodax_builders_mcp_2c237b91/readme" }