[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_104":105},"routes/modules.$creator.$moduleId",{"_14":15,"_16":17,"_18":19,"_20":21},"routes/modules.$creator.$moduleId.endpoints",{"_11":12,"_13":-5},"error","Module '@gosodax/builders-sodax-mcp-server' is not configured","tools","module",{"_20":22,"_23":24,"_25":26,"_27":28,"_29":30,"_31":32,"_33":26,"_34":-5,"_35":36,"_37":-5,"_38":-5,"_39":40,"_41":42,"_43":44,"_45":46,"_47":48,"_49":50,"_51":52,"_53":54,"_55":48,"_56":57,"_58":59,"_60":-5,"_61":-5,"_62":-5,"_63":-5,"_64":65,"_66":67,"_68":69,"_70":71,"_72":73,"_74":-5,"_75":-5,"_76":-5,"_77":48,"_78":-5,"_79":80,"_81":82,"_83":84,"_85":86,"_87":88,"_89":90,"_91":92},"apiUrl","https://odel.app/api","creator","gosodax","moduleId","builders-sodax-mcp-server","@gosodax/builders-sodax-mcp-server","displayName","SODAX Builders MCP","tagline","Cross-network DeFi API data, AMM analytics, and SDK docs for 17+ networks.","iconKey","https://avatars.githubusercontent.com/u/207898235?v=4","category","data","status","published","metaDescription","metaKeywords","deploymentType","external","workerName","bindingName","mcpConfig","{\"url\":\"https://builders.sodax.com/mcp\",\"transport\":\"streamable-http\",\"authType\":\"none\"}","pricingModel","free","creatorUserId","system:external-import","createdAt",1781363440000,"updatedAt",1781499652000,"sourceRegistry","official-mcp-registry","sourceUrl","https://registry.modelcontextprotocol.io/v0/servers?search=io.github.gosodax%2Fbuilders-mcp","sourceVerified",true,"importedAt","upstreamStars",7,"upstreamUpdatedAt",1781168158000,"detectedTransport","detectedAuthType","probeStatus","lastProbedAt","githubRepoUrl","https://github.com/gosodax/builders-sodax-mcp-server","githubRepoFullName","gosodax/builders-sodax-mcp-server","releaseId","ext-gosodax-builders-sodax-mcp-server","version","1.1.0","descriptionMarkdown","# 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 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.\n\n**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.\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 (8 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_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_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\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\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","changelogMarkdown","videoKey","requiredSecretsJson","publishedAt","priceCents","trialDays",0,"categoryDisplayName","Data & Analytics","upstream",{"_95":96,"_97":98,"_99":100,"_101":102,"_103":-5},"requiredSecrets",[],"tags",[],"assets",[],"stats",{"_93":80,"_94":80},"ratingAvg","reviewCount","topics",[],"license","MIT","language","TypeScript","registryName","io.github.gosodax/builders-mcp","homepage","ENV",{"_106":107,"_108":109,"_110":111},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272"]