What can you do with this server?

The MCP-ODOS server enables interaction with decentralized exchanges (DEXs), providing two primary functions: * Fetch Quotes for Swaps: Use the ODOS_GET_QUOTE tool to get swap quotes by specifying parameters like chainId, sellToken, buyToken, and sellAmount. * Execute Swaps: Use the ODOS_EXECUTE_SWAP tool to execute token swaps with parameters including chainId, sellToken, buyToken, sellAmount, quote, and walletProvider. 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.

Which integrations are available for this server?

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.

How do I use MCP-ODOS?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@MCP-ODOS get 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

npm version License: ISC

📖 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:

npx @iqai/mcp-odos

🔧 Build from Source

git clone https://github.com/IQAIcom/mcp-odos.git cd mcp-odos pnpm install pnpm run build

⚡ Running with an MCP Client

Add the following configuration to your MCP client settings (e.g., claude_desktop_config.json).

📋 Minimal Configuration

{ "mcpServers": { "odos": { "command": "npx", "args": ["-y", "@iqai/mcp-odos"], "env": { "WALLET_PRIVATE_KEY": "your_wallet_private_key_here" } } } }

⚙️ Advanced Configuration (Local Build)

{ "mcpServers": { "odos": { "command": "node", "args": ["/absolute/path/to/mcp-odos/dist/index.js"], "env": { "WALLET_PRIVATE_KEY": "your_wallet_private_key_here" } } } }

🔐 Configuration (Environment Variables)

Variable	Required	Description	Default
`WALLET_PRIVATE_KEY`	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
`chain`	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
`chain`	string		"fraxtal"	The blockchain network to execute the transaction on. uses fraxtal as default
`fromToken`	string	✅		The token to swap from (address).
`toToken`	string	✅		The token to swap to (address).
`amount`	string	✅		The amount of tokens to swap, in wei.
`prettyFormat`	boolean		true	Whether to pretty format the quote.

`ODOS_SWAP`

Execute a swap transaction

Parameter	Type	Required	Default	Description
`chain`	string		"fraxtal"	The blockchain network to execute the transaction on. uses fraxtal as default
`fromToken`	string	✅		The token to swap from (address).
`toToken`	string	✅		The token to swap to (address).
`amount`	string	✅		The amount of tokens to swap, in wei.
`prettyFormat`	boolean		true	Whether to pretty format the quote.

👨‍💻 Development

🏗️ Build Project

pnpm run build

👁️ Development Mode (Watch)

pnpm run watch

✅ Linting & Formatting

pnpm run lint pnpm run format

📁 Project Structure

src/tools/: Individual tool definitions
src/services/: API client and business logic
src/utils/: Shared utilities
src/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.

📄 License

ISC

Install Server

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

How are these scores calculated?

Resources

Need Help?

Report Issue

Reddit Discussion

Related Servers

Tools

Appeared in Searches

Finding MCP related to Web3

MCP-ODOS