
SODAX Builders MCP
SODAX Builders MCP: DeFi-данные и AMM-аналитика по 17+ сетям
Что умеет
- Смотреть поддерживаемые сети, токены и конфигурации
- Получать объёмы торгов, стакан и статистику по пулам
- Смотреть позиции пользователя в денежном рынке и AMM
- Строить свечи по AMM-пулам
- Искать транзакции и интенты по идентификатору
Какие данные видит
Доступ к публичным данным протокола SODAX и позициям указанного пользователя по его адресу.
Нужен ли аккаунт
Не нужен: сервер работает без входа
MCP-сервер для разработчиков DeFi-протокола SODAX: конфигурации сетей, поддерживаемые токены, объёмы торгов, стакан, позиции в денежном рынке и AMM-пулах, свечи по пулам и данные заёмщиков и вкладчиков. Подходит для построения и отладки интеграций с SODAX прямо из ассистента.
Как подключить
Как подключить SODAX Builders MCP к Claude
Адрес сервера, который нужно вставить в настройках Claude:
https://builders.sodax.com/mcp
- Откройте Claude (сайт claude.ai или приложение для компьютера).
- Перейдите в Настройки → Коннекторы (в английском интерфейсе: Settings → Connectors).
- Нажмите Добавить пользовательский коннектор (Add custom connector).
- Вставьте адрес сервера, скопированный ниже, в поле URL удалённого MCP-сервера и нажмите Добавить.
- В чате нажмите + → Коннекторы и включите новый коннектор.
Пользовательские коннекторы доступны на тарифах Free, Pro, Max, Team и Enterprise. На Free можно добавить только один. В Team и Enterprise коннектор сначала добавляет владелец организации в Настройки организации → Коннекторы.
Авторизация
После нажатия Добавить откроется окно входа в сервис. Войдите под своим аккаунтом и подтвердите доступ. Пароль Claude не видит.
Как подключить SODAX Builders MCP к ChatGPT
Адрес сервера, который нужно вставить в настройках ChatGPT:
https://builders.sodax.com/mcp
- Откройте ChatGPT в браузере (chatgpt.com). Нужен тариф Plus, Pro, Business, Enterprise или Edu.
- Один раз включите режим разработчика: Настройки → Приложения → Дополнительные настройки → Режим разработчика (Settings → Apps → Advanced settings → Developer mode).
- Откройте Настройки → Коннекторы и нажмите Создать (Create).
- Заполните форму: Название (любое), Описание (одна фраза, что делает сервис), URL MCP-сервера (скопируйте ниже).
- В поле Аутентификация выберите OAuth, если сервис требует вход, иначе Нет. Нажмите Создать.
- В новом чате откройте + → Приложения/Коннекторы и включите коннектор.
Название раздела у OpenAI менялось (Connectors → Apps/Plugins). Если пункт называется иначе, ищите «режим разработчика» в настройках. В рабочих пространствах Business/Enterprise администратор должен разрешить пользовательские коннекторы.
Авторизация
При первом использовании ChatGPT откроет окно входа в сервис. Войдите и подтвердите доступ.
Как подключить SODAX Builders MCP к Cursor
Адрес сервера, который нужно вставить в настройках Cursor:
https://builders.sodax.com/mcp
Быстрый способ: нажмите кнопку Открыть в Cursor ниже, Cursor сам предложит добавить сервер.
Вручную:
- В Cursor откройте Settings → Cursor Settings → MCP и нажмите Add new global MCP server.
- Вставьте JSON, скопированный ниже, в открывшийся файл
~/.cursor/mcp.json(для одного проекта:.cursor/mcp.jsonв корне проекта). - Сохраните файл. Сервер появится в списке MCP; при необходимости пройдите авторизацию по кнопке рядом с ним.
Авторизация
Если сервис требует вход, рядом с сервером в списке MCP появится кнопка авторизации.
Список инструментов сервера (37)
Технические названия из tools/list. Нужны только разработчикам.
| sodax_get_supported_chains | List all blockchain networks supported by SODAX for cross-chain swaps and DeFi operations |
| sodax_get_swap_tokens | Get available tokens for swapping on SODAX, optionally filtered by chain |
| sodax_get_transaction | Look up a specific transaction by its hash to see status, amounts, and details |
| sodax_get_user_transactions | Get intent/transaction history for a specific wallet address |
| sodax_get_volume | Get solver volume data showing filled intents with filtering and pagination. Requires inputToken and outputToken. Optional filters: chain, solver, block range OR time range (don't mix both). |
| sodax_get_volume_stats | Get aggregate solver volume stats: the approximate total number of filled-intent records (fill documents, not distinct intents). Cached ~60s upstream. |
| sodax_get_orderbook | Get current orderbook entries showing pending/open intents |
| sodax_get_money_market_assets | List all assets available for lending and borrowing in the SODAX money market |
| sodax_get_user_position | Get a user's lending and borrowing position in the money market |
| sodax_get_partners | List all SODAX integration partners including wallets, DEXs, and other protocols |
| sodax_get_token_supply | Get SODA token supply information including total, circulating, and burned amounts |
| sodax_get_all_config | Get full SODAX configuration including all supported chains, swap tokens, and protocol settings in one call |
| sodax_get_relay_chain_id_map | Get mapping between chain IDs and intent relay chain IDs used by the SODAX relay network |
| sodax_get_all_chains_configs | Get detailed configuration for all spoke chains including contract addresses, RPCs, and token configs |
| sodax_get_hub_assets | Get assets representing spoke tokens on the hub (Sonic) chain, optionally filtered by source chain |
| sodax_get_money_market_tokens | Get tokens supported for money market lending/borrowing, optionally filtered by chain |
| sodax_get_money_market_reserve_assets | Get money market reserve assets used as collateral backing |
| sodax_get_amm_positions | Get AMM liquidity provider NFT positions, optionally filtered by owner address |
| sodax_get_amm_pool_candles | Get OHLCV candlestick chart data for an AMM pool |
| sodax_get_intent | Look up a specific intent by its intent hash (different from transaction hash) |
| sodax_get_solver_intent | Get solver-side details for an intent including fill history. Use includeAll to see all solver documents. |
| sodax_get_money_market_asset | Get detailed information for a specific money market asset by its reserve address |
| sodax_get_asset_borrowers | Get borrowers for a specific money market asset by its reserve address |
| sodax_get_asset_suppliers | Get suppliers (lenders) for a specific money market asset by its reserve address |
| sodax_get_all_borrowers | Get all borrowers across all money market assets with pagination |
| sodax_get_partner_summary | Get volume and activity summary for a specific integration partner by their receiver address |
| sodax_get_total_supply | Get SODA token total supply as a plain number |
| sodax_get_circulating_supply | Get SODA token circulating supply as a plain number |
| sodax_refresh_cache | Clear both the backend API cache and the solver oracle cache to force fresh fetches on next requests. Reports the number of entries cleared per cache. |
| sodax_get_solver_oracle | Get the solver's oracle USD prices per (chain, token). For quoting with sodax_get_solver_quote, filter chainId='146': chainId-146 addresses pass the quote service's compatibility check, while spoke-chain (non-146) addresses are rejected with 'not compatible with the quote service'. Caveat: passing that check (being listed/priced) does NOT guarantee a swap route — canonical bridged *_ASSET hub tokens and major stablecoins route most reliably, while many wrapped/derivative/money-market entries (e.g. WBTC, waLocBTC, SONIC_SODA_ASSET) are priced but frequently return 'No path was found', and routability is pair/amount/liquidity-dependent. Also useful for sanity-checking quote amounts against the USD prices the solver uses. |
| sodax_get_solver_quote | Get a swap quote from the SODAX solver. tokenSrc/tokenDst MUST be hub-chain (Sonic, chainId 146) asset addresses — look them up with sodax_get_solver_oracle (chainId='146'). Working example: tokenSrc='0xeb0393893b5bf98a50073d6740738b08e575058b' (BTC_BTC_ASSET) → tokenDst='0xaeafa26e43f46cd83efe89b1e57c858eb5685a24' (ETH_ASSET), amount='99800', quoteType='exact_input' returns a quoted_amount. exact_input quotes the destination amount you'd receive; exact_output quotes the source amount you'd need. There are two distinct HTTP-400 failures, both naming the two addresses: (1) 'not compatible with the quote service' = an address isn't a recognized hub asset (a spoke-chain or otherwise non-chainId-146 address was passed) → use a chainId-146 address from sodax_get_solver_oracle, and for a reliable pick prefer a canonical bridged *_ASSET hub token or major stablecoin (chainId 146 alone doesn't guarantee a route). (2) 'No path was found between X and Y' = both tokens are valid hub assets but the solver couldn't route this pair for this amount → routing is pair/amount/liquidity-dependent, so retry with a smaller amount or a more liquid counterparty (a canonical bridged *_ASSET token, or a major stablecoin like SONIC_USDC_ASSET). Many wrapped/derivative entries (e.g. WBTC, waLocBTC, SONIC_SODA_ASSET) are oracle-priced but frequently have no route — prefer canonical bridged *_ASSET hub tokens. |
| sodax_relay_submit_tx | Submit a confirmed spoke-chain transaction to the SODAX intent relay so it can be delivered to the destination chain. The tx must already be finalized on the source chain. Re-submitting the same tx is a no-op. For split-tx chains (Solana, Bitcoin) supply the optional `data` argument. |
| sodax_relay_get_transaction_packets | List every cross-chain packet emitted by a given source transaction. Use this to track relay status — a packet is complete when status='executed' and dst_tx_hash is populated. |
| sodax_relay_get_packet | Fetch a single relay packet by its connection serial number (conn_sn). Returns the packet data on success or a `{success:false, message}` shape if the packet isn't found. |
| docs_health | Check SDK documentation availability. Call this first if docs tools seem unavailable. |
| docs_refresh | Reconnect to SDK documentation and refresh available tools. Use if docs seem stale or unavailable. |
| docs_list_tools | List all SDK documentation tools with parameters. Essential for discovering what's available. |