dex-data-mcp

dex-data MCP server

Twenty-two tools, no API key and no wallet, in three groups:

• Multi-chain DEX market data — token prices, liquidity depth, pool reserves, best execution venue, liquidity risk, pre-trade slippage and gas costs across BNB Chain, Polygon, Arbitrum, Base, Avalanche and Optimism.
• General-purpose agent utilities — geocoding, reverse geocoding, weather, web search, article/PDF to Markdown, and cryptographic randomness.
• Reference and research data — search autocomplete, public holidays and business days, RSS/Atom feeds, IP geolocation, GLEIF legal-entity lookup and the US Treasury yield curve.

Why this exists

The ledger says it plainly. Of 20,392 paywall challenges recorded, zero were genuine third-party queries — 82.5% were our own monitoring, 17.3% were catalogue crawlers walking every route with no parameters. We were being indexed, not shopped.

Bazaar listings are a bet on demand that does not exist yet. MCP is where agents already are today: Claude Desktop, Claude Code, Cursor, and every other MCP host. This server is the same data, delivered where the users are, and it needs no payment at all for the free tier — which removes the one barrier that a browsing agent cannot cross on its own.

Install

Claude Code

claude mcp add dex-data -- npx -y dex-data-mcp

Claude Desktop / Cursor — add to claude_desktop_config.json:

{
  "mcpServers": {
    "dex-data": {
      "command": "npx",
      "args": ["-y", "dex-data-mcp"]
    }
  }
}

No API key, no wallet, no signup. The free tier answers every tool for a daily allowance; after that the endpoints fall back to x402 micropayments.

Tools

DEX market data

tool	answers
get_token_price	USD price of any ERC-20, by ticker or contract address
get_liquidity	market depth and TVL per venue for a pair
get_best_venue	which DEX is cheapest to buy on / best to sell into
get_slippage	price impact for a specific trade size
get_liquidity_risk	DEEP / MODERATE / SHALLOW / VERY_THIN depth class
get_gas	gas cost in USD per chain, ranked cheapest-first (gwei is not comparable across chains)
get_pool_reserves	raw reserves, fee and TVL per venue at one block — the data the others compute from
find_arbitrage	cross-venue arbitrage now, ranked by gross USD at the optimal size, not raw spread
list_chains	supported chains and indexed tokens

General-purpose agent utilities

Not a change of theme — these were chosen the same way everything else here was. Reading USDC receipts across 1,062 x402 seller wallets on Base ranked what actually gets paid for, and DEX data was not near the top of that list. Forward geocoding was (56 paying wallets), then weather, then article-to-Markdown, then randomness. These are the answers to that data.

tool	answers
geocode	address or place name to coordinates, worldwide (OpenStreetMap)
reverse_geocode	coordinates to the nearest street address
get_weather	current conditions plus up to a 7-day forecast for any coordinates
search	free-text web search to ranked organic results, sponsored rows excluded
url_to_markdown	a public article or PDF URL to clean Markdown
get_random	CSPRNG integers or bytes, for agents that cannot generate their own

Reference and research data

Chosen the same way, but from a corrected reading. The category totals in the original scan were double-counted — the biggest x402 sellers carry 10-16 of the 16 category tags each, so every category reported nearly the whole market's revenue. Seller-level rows are clean, and every tool below is something a wallet took real USDC for during the sampled window.

tool	answers
get_search_suggestions	what people actually type about a topic — autocomplete, expanded into questions and comparisons
get_holidays	public and bank holidays for 100+ countries, and whether a given date is a business day
read_feed	any RSS, Atom or RDF feed as clean JSON, summaries in both HTML and plain text
geolocate_ip	where an IP is, with the datacentre/VPN flag that says whether to believe it
lookup_lei	a company's Legal Entity Identifier by name, with lapsed registrations flagged not hidden
get_treasury_yield_curve	the US par yield curve plus 2s10s / 3m10y / 5s30s and the inversion flag

Local

tool	answers
get_spend_budget	what this session has spent on paid calls, and the caps in force

Pairings worth knowing: geocode then get_weather turns a place name into a forecast, search then url_to_markdown turns a question into readable source text, and read_feed then url_to_markdown turns a feed into full articles.

Free tier

Every tool answers free within a daily per-caller allowance — no wallet, no signup. The remaining quota is returned on X-FreeTier-Remaining. Beyond it, calls fall back to x402 micropayments (USDC on Base).

Every response carries the liquidity backing the number and a confidence rating. A quote with no depth behind it is refused rather than returned — a dust-pool price is worse than no price when an agent may trade on it.

Honest limits

• Depth and prices cover the venues this API indexes; a deeper pool may exist on a DEX not covered here.
• v3 figures distinguish custody TVL from tradeable depth at the current price. They are not the same number and are not labelled as if they were.
• get_slippage is pool-level price impact: it excludes gas, MEV and multi-hop routing, and flags v3 estimates that cross the active tick band.