Skip to content
PerpFinder

PerpFinder MCP server

PerpFinder runs a free, read-only MCP server for AI agents at https://perpfinder.com/api/mcp, with 5 tools and no API key. It allows 60 requests per minute per IP. For the stored sweep of September 25, 2026 at 12:55 UTC, get_cheapest_venue returns Lighter for a $10,000 BTC market buy at 0.36 bps all-in.

A read-only Model Context Protocol (MCP) server. AI agents can use it to read the same public data that the site shows. Each answer has a date, a source and a link to the page.

5 toolsKeyless · read-onlySource: Data API

Connect

Endpoint: https://perpfinder.com/api/mcp. The transport is Streamable HTTP without sessions. Send one JSON-RPC message in each POST request. The server does not open an SSE stream, so a GET request gets 405.

Protocol versions: 2025-11-25, 2025-06-18, 2025-03-26. Server name: perpfinder.

# Claude Code
claude mcp add --transport http perpfinder https://perpfinder.com/api/mcp

# Any client with a JSON config
{
  "mcpServers": {
    "perpfinder": { "type": "http", "url": "https://perpfinder.com/api/mcp" }
  }
}

Tools

All read-only
get_cheapest_venue

Venues ranked by measured all-in cost (taker fee + half-spread + price impact) of a perp market buy at the base fee tier, from the newest stored 6-hour order-book sweep. Rows that cannot fill or have unconfirmed depth are listed apart, with the reason.

Arguments: asset: BTC | ETH | SOL | XRP | BNB | DOGE | HYPE, size?: 10000 | 100000 | 1000000. Same data on the site: /cheapest-perp-exchange.

get_venue_fees

Base maker and taker rates, the volume fee ladder, leverage and funding terms of one perp venue, each with its source and check date, plus the measured all-in cost of BTC and ETH market buys.

Arguments: venue: hyperliquid | lighter | aster | bybit | binance | okx | bitget | mexc | …. Same data on the site: /fees.

get_funding

Current perpetual funding rate of one asset on each venue that lists it, normalized to a 1-hour rate, with the venue interval, open interest and price. Rates are fractions: 0.0001 is 0.01%.

Arguments: asset: string. Same data on the site: /funding-rates.

get_volume_ranking

CEX and DEX perpetual venues ranked by reported volume and by adjusted volume. Adjusted is the reported figure with held-out venues removed; each hold-out has a dated reason. Measurements, not accusations.

Arguments: window?: 24h | 7d, limit?: integer. Same data on the site: /perp-volume-ranking.

get_venue_access

For one jurisdiction, what each venue and the local regulator publish about perp access: yes, restricted, unclear or no, with the basis and the sources a person opened. Not legal advice.

Arguments: country: string. Same data on the site: /perps-by-country.

Example request

curl -s https://perpfinder.com/api/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"get_cheapest_venue","arguments":{"asset":"BTC","size":100000}}}'

Rules and limits

The server needs no key and reads no credentials. No tool writes data, and no tool starts a new measurement. Cost answers come from the stored 6-hour order-book sweeps.

The limit is 60 requests per minute per IP. A request body can be up to 16 KB. Batch requests are not supported. Above the limit, the server sends 429 with a Retry-After header.

Every result has asOf, source and page. A missing value is null, not 0. When you use a result, cite “Data: PerpFinder” with the page link. The data license is in the terms.

Country access answers repeat what venues and regulators publish. They are not legal advice.

Terms in the tool results

Total trading cost (all-in cost)
Total trading cost (all-in cost) is the selected-side cost of one order at a given size: the fee plus half of the spread plus the price impact, in bps and USD.
Funding rate
A funding rate is the periodic payment between long and short positions that keeps a perpetual futures price near its index price. When the rate is positive, longs pay shorts.
Reported volume (24h/7d/30d)
Reported volume is the trading volume that the venue or its data source publishes, in USD notional, for the last 24 hours, 7 days or 30 days.