SODAX Builders

You can access live SODAX data and SDK documentation through a dedicated MCP server. This server connects your client to blockchain networks, market data, transactions, and SDK docs, enabling AI-powered queries and rapid integration. It provides up-to-date data with caching for performance and presents SDK documentation that updates automatically as sources change.

How to use

Connect to the MCP server using your preferred MCP client. You can retrieve live data such as supported chains, swap tokens, transactions, trading volume, orderbooks, money market assets, and user positions. You can also query integration partners, the SODA token supply, and access the SDK documentation stream for up-to-date guidance. Use this server to build AI-assisted workflows that fetch data and reference current SDK docs in a single connection.

How to install

Prerequisites You need one of the following environments to run the MCP server: Docker or a local Node.js development setup with PNPM. Choose your preferred deployment path below.

Option A — Docker (recommended for quick start)

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

Option B — Docker Compose

docker-compose up -d

Option C — Local development (Node.js and PNPM)

# Install dependencies
pnpm install

# Run in development mode
pnpm dev

# Build for production
pnpm build

# Start production server
pnpm start

Environment variables

The server supports environment configuration for deployment. The following variables are shown in the deployment notes.

• PORT: Server port (default 3000)

• TRANSPORT: Transport mode (http or stdio)

• NODE_ENV: Set to production for deployment

Deployment notes

You can deploy via Docker, Docker Compose, or automated hosting using nixpacks. For production on hosted environments, set PORT to 3000 and NODE_ENV to production. The server exposes endpoints for status, data tools, and MCP interactions.

API Endpoints

The server exposes these endpoints to interact with data and MCP tools.

GET / — Landing page

GET /api — Server information and tool list

GET /health — Health check

POST /mcp — MCP endpoint

Tools and data you can access

Access core API data tools for chains, swap tokens, transactions, volume, and orderbooks.

Core API Data tools: sodax_get_supported_chains, sodax_get_swap_tokens, sodax_get_transaction, sodax_get_user_transactions, sodax_get_volume, sodax_get_orderbook.

DeFi & Token Data tools: sodax_get_money_market_assets, sodax_get_user_position, sodax_get_partners, sodax_get_token_supply, sodax_refresh_cache.

SDK Documentation tools: docs_* tools that proxy from the GitBook MCP and update automatically.

Security and best practices

Keep the MCP server within trusted networks when handling sensitive data. Regularly refresh cached data to ensure freshness, and monitor health endpoints to detect issues early.

Available tools

sodax_get_supported_chains

List all supported blockchain networks.

sodax_get_swap_tokens

Get available tokens for swapping.

sodax_get_transaction

Look up a transaction by its hash.

sodax_get_user_transactions

Get a user's transaction history.

sodax_get_volume

Get trading volume data.

sodax_get_orderbook

Get current orderbook entries.

sodax_get_money_market_assets

List lending and borrowing assets.

sodax_get_user_position

Get a user's money market position.

sodax_get_partners

List SODAX integration partners.

sodax_get_token_supply

Get SODA token supply information.

sodax_refresh_cache

Clear cached data.

docs_*

Dynamically proxy documentation tools from the GitBook MCP.

docs_list_tools

List all available documentation tools.

docs_health

Check GitBook MCP connection status.

Docs_refresh

Refresh the tools list from GitBook.