Coinfuty MCP Server

The Coinfuty MCP server lets AI assistants query live and historical crypto derivatives data directly — open interest, funding rates, long/short ratios, liquidations and trading volume, aggregated across major futures exchanges. It is free, requires no API key, and is read-only.

MCP (Model Context Protocol) is the open standard AI clients such as Claude, ChatGPT and Cursor use to call external tools. Once connected, your assistant answers questions like “what is BTC funding right now?” or “how did ETH open interest change this week?” with real numbers from Coinfuty.

Endpoint

https://mcp.coinfuty.com/api/mcp

Transport: Streamable HTTP (the current MCP default). No authentication. Rate limit: 60 requests per minute per IP.

Connect from your AI client

• Claude (claude.ai / desktop): Settings → Connectors → Add custom connector → paste the endpoint URL.
• Claude Code: claude mcp add --transport http coinfuty https://mcp.coinfuty.com/api/mcp
• Cursor: Settings → MCP → Add new MCP server → type “streamableHttp”, URL = the endpoint above.
• ChatGPT: Settings → Connectors (developer mode) → add the endpoint as a custom MCP connector.

Example prompts

Once connected, just ask in plain language — your assistant picks the right tool and fills in the parameters:

• “What is the BTC funding rate right now, and which exchange pays the most?”
• “How did ETH open interest change over the last 7 days?”
• “Show the top 10 coins by 24h liquidations.”
• “Compare SOL long/short ratios across exchanges.”
• “Is the market fearful or greedy today?”

Try it with curl

The endpoint speaks plain JSON-RPC over Streamable HTTP, so you can test it without an MCP client. List the available tools:

curl -X POST https://mcp.coinfuty.com/api/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Call a tool — current and accumulated funding rates for BTC on every exchange:

curl -X POST https://mcp.coinfuty.com/api/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"get_funding_rates","arguments":{"symbol":"BTC"}}}'

The response is a server-sent event whose data: line carries the JSON-RPC result:

event: message
data: {"result":{"content":[{"type":"text","text":"{\"data\":{\"oi_weighted_rate_pct\":0.0047,\"exchanges\":[{\"exchange\":\"Binance\",\"rate_pct\":0.01,\"accumulated_pct\":{\"1d\":0.03,\"7d\":0.24,…

Another example — daily open interest history for ETH (metric accepts price, oi, funding, long_short, liquidation or volume; tf accepts 1h, 4h, 12h or 1d):

curl -X POST https://mcp.coinfuty.com/api/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"get_price_history","arguments":{"symbol":"ETH","metric":"oi","tf":"1d"}}}'

Available tools

• get_market_overview — Aggregated futures market snapshot: total open interest, 24h liquidations, Fear & Greed index, average RSI, and a 30-day daily series.
• get_coins_markets — Screener across all tracked coins: price, open interest, funding rate, volume, liquidations, long/short ratio and market cap — sortable, filterable by symbol.
• get_coin_summary — Full derivatives snapshot for one coin, including per-exchange long/short ratios and funding rates.
• get_price_history — Historical series for any metric — price OHLC, open interest, funding rate, long/short ratio, liquidations or volume — on 1h/4h/12h/1d timeframes.
• get_funding_rates — Current and accumulated (1d/7d/30d/1y) funding rates for one coin on every exchange, with settlement intervals and next funding time.
• get_exchange_breakdown — How one coin's open interest, long/short, liquidations or volume splits across exchanges.
• list_exchanges — Top derivatives exchanges with open interest, volume, liquidations, fees and market counts.

Notes

• All monetary values are USD; all timestamps are UTC.
• Live figures update roughly every 10 seconds on the backend; responses may be cached for up to 30–60 seconds.
• The same data is browsable on the Coinfuty dashboard and explained in plain English in our Learn guides.
• Data is provided for informational purposes only — see our Disclaimer.

Feedback

Missing a tool or field you need? Tell us at research@coinfuty.com or via the feedback form.