io.github.gosodax/builders-mcp
编码与调试by gosodax
提供实时 SODAX API 数据与 SDK 文档,覆盖 chains、tokens、swaps、volume 等信息。
什么是 io.github.gosodax/builders-mcp?
提供实时 SODAX API 数据与 SDK 文档,覆盖 chains、tokens、swaps、volume 等信息。
README
SODAX Builders MCP Server
<p align="center"> <b>Install from your preferred MCP directory</b><br><br> <a href="https://glama.ai/mcp/servers/@gosodax/sodax-builders-mcp"><img src="https://img.shields.io/badge/Glama-SODAX_Builders_MCP-4285F4?style=for-the-badge" alt="Glama" /></a> <a href="https://registry.modelcontextprotocol.io/?q=sodax"><img src="https://img.shields.io/badge/MCP_Registry-SODAX-10B981?style=for-the-badge" alt="MCP Registry" /></a> <a href="https://mcp.so/server/sodax-builders-mcp/gosodax"><img src="https://img.shields.io/badge/mcp.so-SODAX_Builders_MCP-8B5CF6?style=for-the-badge" alt="mcp.so" /></a> </p>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
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
常见问题
io.github.gosodax/builders-mcp 是什么?
提供实时 SODAX API 数据与 SDK 文档,覆盖 chains、tokens、swaps、volume 等信息。
相关 Skills
前端设计
by anthropics
面向组件、页面、海报和 Web 应用开发,按鲜明视觉方向生成可直接落地的前端代码与高质感 UI,适合做 landing page、Dashboard 或美化现有界面,避开千篇一律的 AI 审美。
✎ 想把页面做得既能上线又有设计感,就用前端设计:组件到整站都能产出,难得的是能避开千篇一律的 AI 味。
网页构建器
by anthropics
面向复杂 claude.ai HTML artifact 开发,快速初始化 React + Tailwind CSS + shadcn/ui 项目并打包为单文件 HTML,适合需要状态管理、路由或多组件交互的页面。
✎ 在 claude.ai 里做复杂网页 Artifact 很省心,多组件、状态和路由都能顺手搭起来,React、Tailwind 与 shadcn/ui 组合效率高、成品也更精致。
网页应用测试
by anthropics
用 Playwright 为本地 Web 应用编写自动化测试,支持启动开发服务器、校验前端交互、排查 UI 异常、抓取截图与浏览器日志,适合调试动态页面和回归验证。
✎ 借助 Playwright 一站式验证本地 Web 应用前端功能,调 UI 时还能同步查看日志和截图,定位问题更快。
相关 MCP Server
GitHub
编辑精选by GitHub
GitHub 是 MCP 官方参考服务器,让 Claude 直接读写你的代码仓库和 Issues。
✎ 这个参考服务器解决了开发者想让 AI 安全访问 GitHub 数据的问题,适合需要自动化代码审查或 Issue 管理的团队。但注意它只是参考实现,生产环境得自己加固安全。
Context7 文档查询
编辑精选by Context7
Context7 是实时拉取最新文档和代码示例的智能助手,让你告别过时资料。
✎ 它能解决开发者查找文档时信息滞后的问题,特别适合快速上手新库或跟进更新。不过,依赖外部源可能导致偶尔的数据延迟,建议结合官方文档使用。
by tldraw
tldraw 是让 AI 助手直接在无限画布上绘图和协作的 MCP 服务器。
✎ 这解决了 AI 只能输出文本、无法视觉化协作的痛点——想象让 Claude 帮你画流程图或白板讨论。最适合需要快速原型设计或头脑风暴的开发者。不过,目前它只是个基础连接器,你得自己搭建画布应用才能发挥全部潜力。