Graph Uniswap MCP

One MCP interface over Uniswap V2, V3, and V4 across Ethereum, Arbitrum, Base, Polygon, Optimism, and BSC — powered by The Graph. Ask an agent for a price, the top pools, a pair, or recent swaps on any Uniswap deployment and get back clean JSON.

Built to be correct where naive subgraph access goes wrong:

• 🔁 Self-healing — markets are addressed by subgraph ID, so queries always follow the publisher's latest published version. discover_markets re-resolves the best live subgraph from The Graph's network subgraph (ranked by curation signal), so new or replacement deployments surface with no code change.
• 🧬 Schema-adaptive — Uniswap's subgraphs are not uniform (V2 pairs vs V3/V4 pools; classic ethPriceUSD/derivedETH vs newer nativePriceUSD/derivedNative). The server introspects each subgraph once and adapts every query automatically.
• 🚫 Footgun-proofed — Uniswap subgraph TVL is unreliable (one spam-token pool can report trillions in fake liquidity). Every ranking is by volumeUSD, never TVL, and TVL is always returned with a caveat. Prices are derived on-chain and easy to sanity-check (a stablecoin reads ~$1).

Tools

Tool	What it does
list_markets	Every version×chain and its backing subgraph
discover_markets	Re-resolve the best live subgraph from the network subgraph (self-healing)
get_token_price	USD price of a token (symbol or address)
top_pools	Top pools on a chain, ranked by volume
find_pool	Pool(s) for a token pair, either order
pool_info	Full stats for one pool/pair
recent_swaps	Newest swaps, optionally scoped to a pool
raw_query	Arbitrary GraphQL against the resolved subgraph

Every tool takes chain and an optional version (v2/v3/v4). Omit version and it uses the highest-volume version on that chain. Chain aliases (eth, arb, matic, bnb, …) are accepted.

Setup

npm install
npm run build

Get a free Graph gateway API key at https://thegraph.com/studio (Billing → API Keys — first 100k queries/month are free), then add the server to your MCP client:

{
  "mcpServers": {
    "graph-uniswap": {
      "command": "npx",
      "args": ["-y", "graph-uniswap-mcp"],
      "env": { "GRAPH_API_KEY": "your_key_here" }
    }
  }
}

Or run locally: GRAPH_API_KEY=... npm start.

Example calls

get_token_price  { "token": "WETH", "chain": "arbitrum" }
top_pools        { "chain": "base", "version": "v4", "first": 5 }
find_pool        { "tokenA": "WBTC", "tokenB": "USDC", "chain": "ethereum" }
recent_swaps     { "chain": "base", "version": "v4", "first": 10 }
discover_markets { "chain": "arbitrum", "version": "v3" }

Covered markets

13 markets, each backed by a canonical Uniswap-Labs subgraph addressed by subgraph ID (so it auto-follows the publisher's latest version). Query volumes are a rough popularity signal from the operator dashboard.

Version	Chain	What it covers	~Queries/day	Subgraph ID
V4	Base	PoolManager pools + hooks, swaps, fee tiers, prices — highest-volume Uniswap subgraph on the whole network	8.6M	Gqm2b5J85n1bhCyDMpGbtbVn4935EvvdyHdHrx3dibyj
V4	BNB	V4 pools, swaps, fee tiers, prices	1.7M	EAq1nJKgjnuKH6Gj4RFjCW7LcL7E2uipbncdwV7TTWkX
V4	Ethereum	V4 pools, swaps, fee tiers, prices	233K	AdA6Ax3jtct69NnXfxNjWtPTe9gMtSEZx2tTQcT4VHu
V4	Arbitrum	V4 pools, swaps, fee tiers, prices	—	D1VHPU6cXXSC8eaApWCjCnPcTZQFSYCpGoDAvt4ogDWh
V4	Optimism	V4 pools, swaps, fee tiers, prices	—	3Tn7Y1NJAr4ySKm7KFu1dwvH2WM3mHJnXzXAxQsdBDvW
V3	Ethereum	Concentrated-liquidity pools, fee tiers, swaps, positions, prices	467K	5zvR82QoaXYFyDEKLZ9t6v9adgnptxYpKpSbxtgVENFV
V3	Arbitrum	V3 pools, fee tiers, swaps, prices	854K	FbCGRftH4a3yZugY7TnbYgPJVEv2LvMT6oF1fxPe9aJM
V3	Base	V3 pools, fee tiers, swaps, prices — native-pricing schema (nativePriceUSD/derivedNative)	536K	HMuAwufqZ1YCRmzL2SfHTVkzZovC9VL2UAKhjvRqKiR1
V3	Polygon	V3 pools, fee tiers, swaps, prices	539K	EsLGwxyeMMeJuhqWvuLmJEiDKXJ4Z6YsoJreUnyeozco
V3	Optimism	V3 pools, fee tiers, swaps, prices	307K	Cghf4LfVqPiFw6fp6Y5X5Ubc8UpmUhSfJL82zwiBFLaj
V3	BSC	V3 pools, fee tiers, swaps, prices	1.1M	7XgdLW3bts4HktCYsu9dy8bEnuiNeZuftcuK3Aj4JXYV
V2	Ethereum	Constant-product pairs, reserves, swaps, prices	2.4M	GmSczqdCDZ3hJeYY9JphwsADn5rePUzUKm8EZcVuhRAm
V2	Base	V2 pairs, reserves, swaps, prices	1.6M	DbcUmZwXBYbNZvLuDEvcmFa4uAWwwjrdX8dVFg1AUVKa

Call list_markets for this table live, or discover_markets to re-resolve the best current subgraph from The Graph's network subgraph. (V4 is not yet deployed on Polygon.)

Reliability

Built for agents that can't babysit a hung tool call:

• Fail-fast, never hang. Every gateway request is time-boxed by an AbortController (default 15s/attempt), so a stalled indexer returns a clean error instead of hanging your agent. Only genuinely transient failures (indexer lag, 5xx) retry.
• Version fallback (self-healing on the data path). When you don't pin a version and the top market's indexers are down, the server transparently falls back to the next-highest-volume version on that chain and still returns real data — the response's served field tells you which version answered. A pinned version is never silently swapped.
• Tunable via env: GRAPH_HTTP_TIMEOUT_MS (15000), GRAPH_MAX_ATTEMPTS (2), GRAPH_TOTAL_BUDGET_MS (25000).

Keyless pay-per-query (x402)

This server uses a shared GRAPH_API_KEY (free tier: 100k queries/month). If you'd rather an agent pay per query with no API key or account at all, pair it with PayQL — an MCP that runs any Graph subgraph query (including all the Uniswap subgraphs above) over x402, paying ~$0.01 in USDC per call via the gateway's …/api/x402/… path. Gasless (EIP-3009), keyless, wallet-agnostic — the payment is the auth. Use this MCP for the curated Uniswap tools, and PayQL when you want the raw, key-free pay-as-you-go path.

License

MIT © PaulieB14