OpenOcean MCP
OfficialThe OpenOcean MCP server enables decentralized token swaps across multiple blockchain networks via OpenOcean's DEX aggregation API. It provides the following capabilities:
Fetch supported chains: Get a list of all available blockchain networks
View available tokens: Retrieve tradeable tokens for a specified chain (defaults to Fraxtal)
Browse DEX exchanges: Get decentralized exchanges available on a specific chain
Check gas prices: Fetch current gas prices for transactions on a given network
Get swap quotes: Request price quotes for token swaps with customizable slippage (0.05-50%, default 1%)
Build swap transactions: Generate transaction data for executing swaps with specified parameters including
inTokenAddress,outTokenAddress,amount(with decimals),account(wallet address), and optionalslippageTrack transactions: Retrieve transaction details and status using transaction hashes
The server is compatible with MCP clients like AI assistants and IDE extensions, enabling programmatic access to DeFi functionality for comparing rates across DEXs, executing swaps, and monitoring transaction costs.
Click on "Deploy 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., "@OpenOcean MCP get a quote to swap 1 ETH for USDC on Ethereum with 1% slippage"
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.
OPENOCEAN-MCP Server
An MCP server for executing token swaps across multiple decentralized exchanges using OpenOcean's aggregation API.
Overview
This project implements a Model Context Protocol (MCP) server to interact with decentralized exchanges (DEXs). It allows MCP-compatible clients (like AI assistants, IDE extensions, or custom applications) to access functionalities such as getting quotes for swaps and executing swaps across multiple chains.
This server is built using TypeScript and fastmcp.
Related MCP server: SEI DEX MCP
Features (MCP Tools)
The server exposes the following tools that MCP clients can utilize:
CHAIN_LIST: Fetch chain list.Parameters:
GAS_PRICE: Fetch gas price.Parameters:
chain(string)
QUOTE: Fetch a quote for a swap.Parameters:
chain(string),inTokenAddress(string),outTokenAddress(string),amount(string),slippage(string)
SWAP: Building swap transaction.Parameters:
chain(string),inTokenAddress(string),outTokenAddress(string),amount(string),slippage(string),account(string)
GET_TRANSACTION: Fetch transaction info.Parameters:
chain(string),hash(string)
TOKEN_LIST: Fetch token list.Parameters:
chain(string)
DEX_LIST: Fetch dex list.Parameters:
chain(string)
Parameter breakdown
chain: The chain code of the DEX.inTokenAddress: The token you want to sell.outTokenAddress: The token you want to buy.amount: Token amount with decimals. For example, if 1 USDT is input, use 1000000 (1 USDT * 10^6).slippage: Define the acceptable slippage level by inputting a percentage value within the range of 0.05 to 50. 1% slippage set as 1.account: user's wallet address.hash: Hash from the OpenOcean contract on the blockchain.
Prerequisites
Node.js (v18 or newer recommended)
pnpm (See https://pnpm.io/installation)
Installation
There are a few ways to use openocean-mcp:
1. Using pnpm dlx (Recommended for most MCP client setups):
You can run the server directly using pnpm dlx without needing a global installation. This is often the easiest way to integrate with MCP clients. See the "Running the Server with an MCP Client" section for examples.
(pnpm dlx is pnpm's equivalent of npx)
2. Global Installation from npm (via pnpm):
Install the package globally to make the openocean-mcp command available system-wide:
pnpm add -g openocean-mcp3. Building from Source (for development or custom modifications):
Clone the repository:
git clone https://github.com/openocean-finance/openocean-mcp.git cd openocean-mcpInstall dependencies:
pnpm installBuild the server: This compiles the TypeScript code to JavaScript in the
distdirectory.pnpm run buildThe
preparescript also runspnpm run build, so dependencies are built upon installation if you clone and runpnpm install.
Configuration (Environment Variables)
This MCP server may require certain environment variables to be set by the MCP client that runs it. These are typically configured in the client's MCP server definition (e.g., in a mcp.json file for Cursor, or similar for other clients).
Any necessary environment variables for wallet providers or API keys.
Running the Server with an MCP Client
MCP clients (like AI assistants, IDE extensions, etc.) will run this server as a background process. You need to configure the client to tell it how to start your server.
Below is an example configuration snippet that an MCP client might use (e.g., in a mcp_servers.json or similar configuration file). This example shows how to run the server using the published npm package via pnpm dlx.
{
"mcpServers": {
"openocean-mcp-server": {
"command": "pnpm",
"args": ["dlx", "openocean-mcp"]
}
}
}Alternative if Globally Installed:
If you have installed openocean-mcp globally (pnpm add -g openocean-mcp), you can simplify the command and args:
{
"mcpServers": {
"openocean-mcp-server": {
"command": "openocean-mcp",
"args": []
}
}
}command: The executable to run.For
pnpm dlx:"pnpm"(with"dlx"as the first arg)For global install:
"openocean-mcp"
args: An array of arguments to pass to the command.For
pnpm dlx:["dlx", "openocean-mcp"]For global install:
[]
env: An object containing environment variables to be set when the server process starts. This is where you provide any necessary environment variables.workingDirectory: Generally not required when using the published package viapnpm dlxor a global install, as the package should handle its own paths correctly. If you were running from source (node dist/index.js), then settingworkingDirectoryto the project root would be important.
Available Tools
7 toolsCHAIN_LISTC
Get chain list
Inputs: no named parameters.
DEX_LISTC
Get dex list
Inputs: chain.
GAS_PRICEC
Get gas price
Inputs: chain.
GET_TRANSACTIOND
Get Transaction
Inputs: hash (required), chain.
QUOTEC
Quote the price of a specific trading pair
Inputs: inTokenAddress (required), outTokenAddress (required), amount (required), chain, +1 more.
SWAPC
Building swap transaction
Inputs: inTokenAddress (required), outTokenAddress (required), amount (required), account (required), +2 more.
TOKEN_LISTC
Get token list
Inputs: chain.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Each tool has a clearly distinct purpose targeting different aspects of DeFi operations: chain management, DEX listings, gas pricing, transaction retrieval, price quoting, swap building, and token listings. There is no overlap in functionality, making tool selection straightforward for an agent.
Most tools follow a consistent verb_noun pattern (e.g., GET_TRANSACTION, GAS_PRICE, TOKEN_LIST), but there are minor deviations: CHAIN_LIST and DEX_LIST use noun_verb order, and QUOTE and SWAP are single verbs without nouns. The naming is still readable and mostly predictable.
With 7 tools, the server is well-scoped for a DeFi/blockchain utility, covering essential operations like listing resources, pricing, transactions, and swaps. Each tool earns its place without feeling bloated or insufficient for the domain.
The toolset provides strong coverage for core DeFi workflows: resource listing (chains, DEXs, tokens), pricing (gas, quotes), and transaction handling (get, build swaps). A minor gap is the lack of tools for managing user accounts or executing swaps directly, but agents can work around this with the provided building blocks.
Maintenance
Related MCP Connectors
OpenFinance gives any AI agent easy trading across every major market through one hosted MCP server. Trade crypto spot and perpetuals on Hyperliquid with market, limit and TWAP orders, leverage and margin control. Trade stocks, indices, commodities, forex and pre-IPO names as Hyperliquid HIP-3 perps. Trade Polymarket prediction markets with odds, order books, positions, PnL and trader leaderboards. Swap and bridge across 40+ EVM chains and Solana with Relay and Jupiter, find memecoins across 200+ chains, launch tokens on Robinhood Chain and Solana, and buy crypto with card, bank or UPI. Write actions are designed to ask for your confirmation first. Connect with OAuth (sign in to OpenFinance and approve) or an API key. Works with Claude, ChatGPT, Cursor, VS Code, Codex and any MCP client. No install. Home: https://openfinance.tech/agents · Docs: https://docs.openfinance.tech · GitHub: https://github.com/openfinance-tech/mcp
Doc search, intent & cross-chain swaps, limit orders, portfolio, spot prices, gas & all APIs.
On-chain DEX aggregator: quotes and verified swap calldata computed on your own RPC. No API key.
Non-custodial DEX aggregator for autonomous AI agents: best-price swaps on 8 chains, no API key.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables interaction with DeFi trading and portfolio analytics through Odos DEX aggregation and Zerion APIs. Provides access to swap quotes, liquidity operations, token pricing, portfolio analysis, and transaction history across multiple blockchain networks.3-
- AlicenseNot gradedqualityDmaintenanceEnables interaction with decentralized exchanges on the SEI blockchain through natural language commands. Supports token swapping, wrapping, liquidity pool queries, and automated trading strategies on DragonSwap.ISC
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to automate token swaps on Uniswap DEX across multiple blockchains including Ethereum, Optimism, Polygon, Arbitrum, and more, with real-time price quotes, swap execution, and multi-hop route optimization.MIT

onchainos MCP Serverofficial
AlicenseNot gradedqualityBmaintenanceEnables on-chain operations including token search, market data, wallet management, swap execution, and DApp interactions across 20+ blockchains.346MIT