o1-mcp
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., "@o1-mcp Get a quote to swap 1 ETH for USDC on Base"
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.
o1-mcp
An MCP server that exposes the o1.exchange DEX aggregator — live swap quotes and routing on Base — to any MCP client (Claude Desktop, Claude Code, …). Read-only and safe by default: no private keys, no signing, no broadcasting. It returns routing data and, optionally, unsigned calldata you sign in your own wallet.
Tools
Tool | Endpoint | What it does |
|
| Liveness check. No auth. |
|
| Primary. Quote a swap → compact route summary + |
| — | The DEX venues the router can use on Base. |
|
| Gated. Turn a |
|
| Gated. One-shot quote + unsigned calldata. |
The two gated tools register only when O1_ENABLE_BUILD_TX=true. They never sign or broadcast — you do, in your own wallet.
o1_get_quote takes tokenIn, tokenOut (an EVM address or "ETH"), and amountIn (base units / wei, as a string > 0). Optional: slippageBps (default 100, capped at 2000 unless O1_ALLOW_HIGH_SLIPPAGE=true), chainId, maxHops, splitEnabled, allowedDexes, feeBps, timeBudgetMs. It returns:
{
"quoteId": "…", "expiresAt": 1782700000000,
"expectedAmountOut": "…", "minAmountOut": "…",
"feeBps": 5, "gasUnits": "210000",
"venues": ["AERODROME_V2LIKE", "UNIV3"],
"routesCount": 2,
"note": "quote expires ~10s",
"raw": { /* full /quote response */ }
}Selling ETH? Set
useNativeIn: trueon the gated tools, or the calldata'svaluecomes back0. Quotes expire in ~10s and are never cached.
Related MCP server: dex-quotes
Demo
Verified live in Claude Code — the read-only tools load and respond against production:


o1_health→ ✅/healthreturned{ ok: true }·o1_list_supported_dexes→ 21 DEX venues on Base (chain ID 8453). The gatedo1_build_swap_transactionando1_execute_swaptools appear onceO1_ENABLE_BUILD_TX=true.
Tools for o1 — 3 tools
1. o1_health read-only, open-world
2. o1_get_quote read-only, open-world
3. o1_list_supported_dexes read-onlyo1_list_supported_dexes → UNIV2, UNIV3, UNIV4, AERODROME_V2LIKE, AERODROME_CL, PANCAKE_V2, PANCAKE_V3, PANCAKE_INFINITY_CL, HYDREX, QUICKSWAP_V4, ALIEN_BASE_V3, CURVE, PROPSWAP, TESSERA, ELFOMOFI, LUNARBASE, FELTIR, DODO_V2, WOOFI, GYROSCOPE_ECLP, MAVERICK_V2.
Quick start
Requires Node 20+.
npm install
npm run build
cp .env.example .env # set O1_API_KEY and O1_API_BASE_URLAdd it to your MCP client (stdio):
{
"mcpServers": {
"o1": {
"command": "node",
"args": ["/absolute/path/to/o1-mcp/dist/index.js"],
"env": {
"O1_API_BASE_URL": "https://quiet-bloodhound-531.convex.site",
"O1_API_KEY": "your-key-here"
}
}
}
}Claude Code: claude mcp add o1 -- node /absolute/path/to/o1-mcp/dist/index.js.
Environment
Var | Required | Default | Notes |
| ✅ | — | Aggregator base URL, no trailing slash. Prod: |
| for non-health | — | Sent as |
|
| Default slippage (bps) when a quote omits it. | |
|
| Chain allowlist. Base only (phase 1). | |
|
| Register the gated | |
|
| Per-request timeout (ms). | |
|
| Retries for | |
|
| Allow slippage above the 2000 bps cap. | |
|
|
|
Safety
Read-only by default — swap-building tools are opt-in via
O1_ENABLE_BUILD_TX.No private keys, ever — no tool accepts one, and output is always unsigned.
Inputs validated before any network call — address format,
amountIn > 0, slippage cap, chain allowlist.Secrets redacted from every log and error; logs go to stderr only (stdout carries only the MCP stream).
Errors mapped —
400invalid input ·401auth ·429rate-limited (with backoff) ·5xxupstream. Reads (/health,/quote) retry with backoff + jitter; writes (/submit,/execute) never do.
Development
npm run typecheck # strict tsc
npm run lint # eslint
npm test # vitest (mocked fetch — no live network)
npm run dev # run from source via tsxLicense
MIT
Available Tools
3 toolso1_get_quoteo1 Get QuoteARead-only
Get a live DEX-aggregator swap quote on Base (o1.exchange). Read-only — no wallet or signing. Pass token addresses or "ETH". amountIn is in base units (wei). Returns a compact route summary + raw. Quotes expire in ~10s.
Inputs: tokenIn (required), amountIn (required), tokenOut (required), feeBps, +6 more.
o1_healtho1 HealthARead-only
Check o1.exchange aggregator liveness (GET /health). No auth, no parameters. Returns { ok, raw }.
Inputs: no named parameters.
o1_list_supported_dexeso1 Supported DEXesARead-only
List the DEX venues (DexId enum) the o1 aggregator can route through on Base. No parameters.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool has a clearly distinct purpose: quotes, health check, and listing supported DEXs. No overlap or ambiguity.
All tools follow the 'o1_' prefix with descriptive names. While 'o1_health' is a noun instead of verb_noun, the pattern is still clear and consistent.
Three tools is appropriate for a focused read-only aggregator interface. Each tool serves a necessary function without excess.
Covers core read operations (quote, health, supported DEXs) for the aggregator. Missing swap execution or token details, but the scope is explicitly read-only.
Maintenance
Related MCP Connectors
Best-route swap quotes, token search and USD prices across EVM chains. Read-only, never trades.
Swap quotes + unsigned txs on 8 EVM chains, plus Solana data: boards, candles, wallet PnL. No key.
On-chain DEX aggregator: quotes and verified swap calldata computed on your own RPC. No API key.
Free non-custodial EVM swap & bridge quotes with unsigned tx; 0.25% disclosed fee on swaps
Related MCP Servers
- AlicenseAqualityCmaintenanceOn-chain price feeds from Base DEX pools. Get spot prices, TWAP, liquidity depth, price impact, and historical OHLCV.724 npm1MIT
- AlicenseNot gradedqualityCmaintenanceGet the best swap quotes across Uniswap, SushiSwap, Aerodrome with pay-per-call via x402 (USDC on Base).MIT
- AlicenseAqualityBmaintenanceEnables AI agents to obtain on-chain DEX aggregator quotes computed by the on-chain Quoter contract through their own RPC node, returning verified unsigned swap calldata, simulations, token info, deployment registry checks, and live staking solvency. All tools are read-only and keyless, so the agent never signs or holds a private key.7532 npm1MIT
- AlicenseNot gradedqualityCmaintenanceEnables users and agents to obtain MEV-protected multichain swap and cross-chain bridge quotes, check supported chains, and generate prefilled swap URLs, with gasless Permit2 execution and x402 or API-key access.457 npmMIT