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.
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-onlyget_cheapest_venueVenues 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.
get_venue_feesBase 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.
get_fundingCurrent 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%.
get_volume_rankingCEX 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.
get_venue_accessFor 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.
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.