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> &nbsp; <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> &nbsp; <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:

json
{
  "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:

json
{
  "mcpServers": {
    "sodax-builders": {
      "url": "https://builders.sodax.com/sse"
    }
  }
}

Tools

Network Configuration (8 tools)

ToolDescription
sodax_get_supported_chainsList all blockchain networks supported by SODAX for cross-chain swaps
sodax_get_swap_tokensGet available tokens for cross-network swapping, optionally filtered by chain
sodax_get_all_configGet full SODAX configuration (chains + tokens) in one call
sodax_get_all_chains_configsDetailed spoke chain configs with contract addresses and RPCs
sodax_get_relay_chain_id_mapChain ID to intent relay chain ID mapping
sodax_get_hub_assetsHub (Sonic) assets representing spoke tokens
sodax_get_money_market_tokensMoney market supported tokens by chain
sodax_get_money_market_reserve_assetsMoney market reserve assets

Intents & Solver (6 tools)

ToolDescription
sodax_get_transactionLook up an intent transaction by hash — status, amounts, and details
sodax_get_intentLook up a specific intent by its intent hash
sodax_get_user_transactionsGet intent/transaction history for a specific wallet address
sodax_get_volumeGet solver volume data (filled intents) with filtering and pagination
sodax_get_orderbookGet current cross-chain orderbook entries from solver
sodax_get_solver_intentGet solver-side intent details and fill history

AMM & Liquidity (2 tools)

ToolDescription
sodax_get_amm_positionsGet AMM liquidity provider NFT positions by owner
sodax_get_amm_pool_candlesGet OHLCV candlestick chart data for an AMM pool

Money Market (6 tools)

ToolDescription
sodax_get_money_market_assetsList all lending/borrowing assets and rates
sodax_get_money_market_assetGet detailed info for a specific asset by reserve address
sodax_get_user_positionGet a user's money market position (supply, borrow, health)
sodax_get_asset_borrowersGet borrowers for a specific money market asset
sodax_get_asset_suppliersGet suppliers (lenders) for a specific money market asset
sodax_get_all_borrowersGet all borrowers across all money market assets

Partners & Token (6 tools)

ToolDescription
sodax_get_partnersList SODAX integration partners across networks
sodax_get_partner_summaryGet volume and activity summary for a specific partner
sodax_get_token_supplyGet SODA token supply info (total, circulating, burned)
sodax_get_total_supplyGet SODA total supply as a plain number
sodax_get_circulating_supplyGet SODA circulating supply as a plain number
sodax_refresh_cacheClear 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.

ToolDescription
docs_searchDocumentationSearch cross-chain SDK docs, integration guides, and code examples
docs_list_toolsList all available documentation tools
docs_healthCheck GitBook MCP connection status
docs_refreshRefresh 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

SourceTypeCache
SODAX API (api.sodax.com)Live cross-network data2 min
AggregatorCross-chain swap token data2 min
GitBook (docs.sodax.com)SDK documentationAuto-sync

Local Development

bash
# Install dependencies
pnpm install

# Run in development mode
pnpm dev

# Build for production
pnpm build

# Start production server
pnpm start

Environment Variables

VariableDefaultDescription
PORT3000Server port
TRANSPORThttpTransport mode (http or stdio)
NODE_ENV-Set to production for deployment

Deployment

Docker

bash
docker build -t builders-sodax-mcp-server .
docker run -p 3000:3000 builders-sodax-mcp-server

Docker Compose

bash
docker-compose up -d

Railway/Coolify

The included nixpacks.toml handles deployment automatically. Set these environment variables:

  • PORT=3000
  • NODE_ENV=production

API Endpoints

EndpointDescription
GET /Landing page
GET /apiServer info and tool list
GET /healthHealth check
POST /mcpMCP endpoint (streamable HTTP)
GET /sseSSE endpoint (legacy transport)
POST /messagesSSE message endpoint

Related

  • SODAXsodax.com
  • SDK Documentationdocs.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

Universal
热门

面向组件、页面、海报和 Web 应用开发,按鲜明视觉方向生成可直接落地的前端代码与高质感 UI,适合做 landing page、Dashboard 或美化现有界面,避开千篇一律的 AI 审美。

想把页面做得既能上线又有设计感,就用前端设计:组件到整站都能产出,难得的是能避开千篇一律的 AI 味。

编码与调试
未扫描111.8k

网页构建器

by anthropics

Universal
热门

面向复杂 claude.ai HTML artifact 开发,快速初始化 React + Tailwind CSS + shadcn/ui 项目并打包为单文件 HTML,适合需要状态管理、路由或多组件交互的页面。

在 claude.ai 里做复杂网页 Artifact 很省心,多组件、状态和路由都能顺手搭起来,React、Tailwind 与 shadcn/ui 组合效率高、成品也更精致。

编码与调试
未扫描111.8k

网页应用测试

by anthropics

Universal
热门

用 Playwright 为本地 Web 应用编写自动化测试,支持启动开发服务器、校验前端交互、排查 UI 异常、抓取截图与浏览器日志,适合调试动态页面和回归验证。

借助 Playwright 一站式验证本地 Web 应用前端功能,调 UI 时还能同步查看日志和截图,定位问题更快。

编码与调试
未扫描111.8k

相关 MCP Server

GitHub

编辑精选

by GitHub

热门

GitHub 是 MCP 官方参考服务器,让 Claude 直接读写你的代码仓库和 Issues。

这个参考服务器解决了开发者想让 AI 安全访问 GitHub 数据的问题,适合需要自动化代码审查或 Issue 管理的团队。但注意它只是参考实现,生产环境得自己加固安全。

编码与调试
83.1k

by Context7

热门

Context7 是实时拉取最新文档和代码示例的智能助手,让你告别过时资料。

它能解决开发者查找文档时信息滞后的问题,特别适合快速上手新库或跟进更新。不过,依赖外部源可能导致偶尔的数据延迟,建议结合官方文档使用。

编码与调试
51.8k

by tldraw

热门

tldraw 是让 AI 助手直接在无限画布上绘图和协作的 MCP 服务器。

这解决了 AI 只能输出文本、无法视觉化协作的痛点——想象让 Claude 帮你画流程图或白板讨论。最适合需要快速原型设计或头脑风暴的开发者。不过,目前它只是个基础连接器,你得自己搭建画布应用才能发挥全部潜力。

编码与调试
46.2k

评论