CoW Protocol MCP Server
An MCP (Model Context Protocol) server for interacting with CoW Protocol's order book API.
Features
Token Tools
- cow_resolve_token - Look up token address by symbol (uses official CoW Swap token list)
- cow_search_tokens - Search for tokens by name/symbol across networks
Order Tools
- cow_get_quote - Get price and fee quotes for trades (accepts symbols OR addresses)
- cow_get_order - Get full order details by UID
- cow_get_order_status - Check order status (open, filled, cancelled, expired)
- cow_get_trades - Fetch trade history for an address or order
- cow_get_auction - View current auction batch information
Token Resolution
The server uses the official CoW Protocol token list for symbol resolution. This is the same list used by CoW Swap.
Example: Instead of providing the full address for USDC or COW, you can just use the symbol: `` sellToken: "WETH" buyToken: "COW" ``
And it will automatically resolve to the correct address for the specified network.
Supported Networks
- mainnet (Ethereum)
- gnosis (Gnosis Chain)
- arbitrum (Arbitrum One)
- base (Base)
- avalanche (Avalanche)
- polygon (Polygon)
- bnb (BNB Chain)
- sepolia (Sepolia testnet)
Installation
npm install
npm run buildUsage
With Claude Desktop
Add to your Claude Desktop config:
{
"mcpServers": {
"cow": {
"command": "node",
"args": ["/path/to/cow-mcp-server/dist/index.js"]
}
}
}With OpenClaw
Add to your OpenClaw MCP servers configuration.
Testing with MCP Inspector
npx @modelcontextprotocol/inspector node dist/index.jsDevelopment
# Watch mode
npm run dev
# Build
npm run build
# Clean
npm run cleanAPI Reference
cow_get_quote
Get a quote for a potential trade:
{
"network": "mainnet",
"sellToken": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
"buyToken": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"kind": "sell",
"amount": "1000000000000000000",
"from": "0xYourAddress"
}cow_get_order_status
Check an order's status:
{
"network": "mainnet",
"orderUid": "0x..."
}cow_get_trades
Get trade history:
{
"network": "mainnet",
"owner": "0xYourAddress",
"limit": 20
}License
MIT
