Bsc Dex Spread MCP server

bsc-dex-spread

One MCP tool — getdexspread — returning live cross-DEX price and spread for PancakeSwap v2 + v3 on BSC, paid $0.01 USDC per call from your own wallet.

Try it in 30 seconds

Inspecting the server costs nothing and needs no wallet:

npx -y bsc-dex-spread-mcp

It starts on stdio and lists its one tool. Add it to Claude Code:

claude mcp add bsc-dex-spread --env EVM_PRIVATE_KEY=0xyour_disposable_base_key -- npx -y bsc-dex-spread-mcp

Without a key the tool is still listed, and a call tells you exactly what is missing rather than failing obscurely:

get_dex_spread failed: EVM_PRIVATE_KEY is not set. Add your funded Base-mainnet
buyer wallet key (0x-prefixed, USDC-only, low balance) to the MCP server env config.

Before you fund anything, know the free alternative. If you do not specifically need the paid, uncapped path, arb-dex-mcp and dex-data-mcp return cross-DEX spread keyless and free on six chains. This server exists for callers who want per-call billing with no free-tier ceiling — it is not the cheapest way in.

An MCP server that gives your agent one tool — getdexspread — returning real-time cross-DEX price & spread data for PancakeSwap v2 + v3 on BSC. Each call is a paid API call: $0.01 USDC on Base mainnet, settled automatically over x402 from your own wallet. No subscription, no account, no API key to request — the agent pays per call.

Backed by a live x402 gateway: Public usage/proof page:

The tool

getdexspread(pair, fee?)

Real-time cross-DEX price & spread for PancakeSwap v2+v3 on BSC.

USD-priceable side. Examples: WBNB/USDC, WBNB/USDT, CAKE/WBNB.

• pair (required) — token pair as SYM/SYM; the first symbol is the

to restrict the v3 probe. Omit to probe all v3 tiers and v2.

• fee (optional) — a PancakeSwap v3 fee tier (100, 500, 2500, 10000)

Returns per-venue prices, best buy / best sell venue, the gross cross-DEX spread in bps, liquidity (per-venue TVL + totals), and the source block number. Example:

{
  "pair": "WBNB/USDC", "network": "bsc", "chainId": 56,
  "blockNumber": 107562007, "nativeUsd": 546.6,
  "pricesByVenue": [ { "venue": "pancake", "surface": "v2", "price": 546.6, "tvlUsd": 1234567 }, ... ],
  "bestBuy":  { "venue": "pancakeV3:500", "price": ... },
  "bestSell": { "venue": "biswap",        "price": ... },
  "midSpreadBps": 27.4,
  "crossDex": { "grossSpreadBps": 14.05, "buyVenue": "...", "sellVenue": "...", "surface": "v2v3" },
  "liquidity": { "venues": 7, "totalTvlUsd": ... },
  "ts": "2026-07-01T...", "source": "rpc"
}

Why an agent wants this

Cross-DEX spread is the raw signal behind arbitrage, best-execution routing, and slippage estimation. Instead of running BSC RPC infrastructure and multi-DEX pool math itself, an agent calls one tool and pays a cent for a fresh, block-stamped answer across PancakeSwap v2 + v3 venues.

Cost & wallet model — read this

You bring the wallet. This package ships no keys. The server signs each payment with a private key it reads from its own environment (EVMPRIVATEKEY), which you set in your MCP client's server config. That is the design: the buyer (you) pays for the data with the buyer's wallet.

Shortened. The full README is on GitHub.