CoW Protocol 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 build

Usage

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.js

Development

# Watch mode
npm run dev

# Build
npm run build

# Clean
npm run clean

API 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