The MCP-ODOS server enables interaction with decentralized exchanges (DEXs), providing two primary functions:
Fetch Quotes for Swaps: Use the
ODOS_GET_QUOTEtool to get swap quotes by specifying parameters likechainId,sellToken,buyToken, andsellAmount.Execute Swaps: Use the
ODOS_EXECUTE_SWAPtool to execute token swaps with parameters includingchainId,sellToken,buyToken,sellAmount,quote, andwalletProvider.
The server is designed to work seamlessly with MCP-compatible clients such as AI assistants or IDE extensions, and can be configured using environment variables like WALLET_PRIVATE_KEY.
Requires Node.js runtime (v18 or newer) to execute the MCP server for decentralized exchange operations.
Implements the MCP server functionality using TypeScript, providing type-safe interaction with decentralized exchanges.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MCP-ODOSget a quote for swapping 1 ETH to USDC on Ethereum"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
π Odos MCP Server
π Overview
The Odos MCP Server enables AI agents to interact with Odos, a leading DEX aggregator that finds optimal swap routes across multiple decentralized exchanges. This server provides comprehensive access to quote retrieval and swap execution functionality.
By implementing the Model Context Protocol (MCP), this server allows Large Language Models (LLMs) to fetch swap quotes, compare prices, and execute token swaps directly through their context window, bridging the gap between AI and decentralized finance.
Related MCP server: EVM MCP Server
β¨ Features
Quote Retrieval: Get optimal swap quotes with best routes across multiple DEXs.
Multi-Chain Support: Execute swaps on various blockchain networks including Fraxtal, Ethereum, and more.
Swap Execution: Execute token swaps with automatic allowance handling.
Chain ID Lookup: Retrieve chain IDs for supported blockchain networks.
π¦ Installation
π Using npx (Recommended)
To use this server without installing it globally:
π§ Build from Source
β‘ Running with an MCP Client
Add the following configuration to your MCP client settings (e.g., claude_desktop_config.json).
π Minimal Configuration
βοΈ Advanced Configuration (Local Build)
π Configuration (Environment Variables)
Variable | Required | Description | Default |
| Yes | Your wallet private key for executing swaps | - |
π‘ Usage Examples
π Getting Quotes
"Get a quote to swap 1000 USDC for FRAX on Fraxtal."
"What's the best rate to swap ETH for USDC?"
"How much FRAX will I get for 100 USDC on Fraxtal?"
π± Executing Swaps
"Swap 100 USDC for FRAX on Fraxtal."
"Execute a trade: sell 1000 USDC for ETH."
"Trade my USDC for the maximum amount of FRAX."
π Chain Information
"What is the chain ID for Fraxtal?"
"Get the chain ID for Ethereum mainnet."
π οΈ MCP Tools
ODOS_GET_CHAIN_ID
Get the chain ID for a given chain name
Parameter | Type | Required | Description |
| string | β | The chain name to get the ID for |
ODOS_GET_QUOTE
Get a quote for a swap or exchange operation
Parameter | Type | Required | Default | Description |
| string | "fraxtal" | The blockchain network to execute the transaction on. uses fraxtal as default | |
| string | β | The token to swap from (address). | |
| string | β | The token to swap to (address). | |
| string | β | The amount of tokens to swap, in wei. | |
| boolean | true | Whether to pretty format the quote. |
ODOS_SWAP
Execute a swap transaction
Parameter | Type | Required | Default | Description |
| string | "fraxtal" | The blockchain network to execute the transaction on. uses fraxtal as default | |
| string | β | The token to swap from (address). | |
| string | β | The token to swap to (address). | |
| string | β | The amount of tokens to swap, in wei. | |
| boolean | true | Whether to pretty format the quote. |
π¨βπ» Development
ποΈ Build Project
ποΈ Development Mode (Watch)
β Linting & Formatting
π Project Structure
src/tools/: Individual tool definitionssrc/services/: API client and business logicsrc/utils/: Shared utilitiessrc/index.ts: Server entry point
π Resources
β οΈ Disclaimer
This project is an unofficial tool and is not directly affiliated with Odos. It interacts with financial data and decentralized exchanges. Users should exercise caution and verify all data independently. Trading on decentralized exchanges involves risk.