mcp

bykaranteli-mcp

MCP (Model Context Protocol) server for live crypto derivatives data: funding rates, cross-exchange funding arbitrage, open interest pressure, liquidations, options, ETF flows, Fear & Greed and BTC dominance.

45 read-only tools over the public JSON API of bykaranteli.com. Since 2026-09-17 the API asks programs for an account key: a free key comes with any verified account at https://bykaranteli.com/dashboard/api (30 requests a minute, public depth), and the Builder, Business and Scale plans raise the rate and unlock member depth (LiqMap on seven timeframes, 5-minute series, the x402 catalog included). Set it as BYKARANTELI_API_KEY. Data covers Binance USDT-M perpetuals (funding arbitrage additionally compares OKX, Bybit, Gate, HTX, BingX, Kraken, MEXC and Bitget).

Hosted endpoint (no install)

Paste https://mcp.bykaranteli.com as a custom connector in any MCP-capable assistant. Same 45 tools, nothing to install. Without a key it runs on the shared Free pool; a connector header Authorization: Bearer bk_... (Builder and above) brings your own rate limit and member depth.

Quick start

Claude Code

claude mcp add bykaranteli -e BYKARANTELI_API_KEY=bk_... -- npx -y bykaranteli-mcp

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "bykaranteli": {
      "command": "npx",
      "args": ["-y", "bykaranteli-mcp"],
      "env": { "BYKARANTELI_API_KEY": "bk_..." }
    }
  }
}

Cursor / other MCP clients

Any stdio MCP client works: command npx, args ["-y", "bykaranteli-mcp"], env BYKARANTELI_API_KEY.

Requires Node.js 18 or newer.

Tools

All responses are JSON and carry a generatedAt timestamp plus a source URL to the human-readable page. Symbols accept both BTCUSDT and bare BTC.

Configuration

Data notes

• The signal engine was retired in September 2026; this server publishes recorded market data only, no trading signals or performance claims.
• Funding, OI and pressure data refresh every 15 to 30 minutes; indices every 30 minutes.
• Nothing here is financial advice. See bykaranteli.com/risk-guide.

Development

npm install
npm run build
node dist/index.js   # speaks MCP over stdio

License

Server: MIT. Data: personal and research use with attribution "ByKaranteli (bykaranteli.com)"; commercial use with the Business plan. Licence text: https://bykaranteli.com/data#license.

Plans and paid depth

Full table: https://bykaranteli.com/developers#tiers. For recorded history and raw records beyond the live snapshots, bykaranteli.com also exposes pay-per-call x402 endpoints for anonymous agents (USDC on Solana or Base, priced per call, no account): https://bykaranteli.com/developers#x402 · machine catalog: https://bykaranteli.com/api/x402. Builder and higher keys call those routes unpaid within their plan limits.