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.

50 read-only tools over the public JSON API of bykaranteli.com. Since 2026-09-10 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, liquidations, order book depth, options, positioning and insurance funds add the other venues each board lists on bykaranteli.com/coverage.

Hosted endpoint (no install)

Paste https://mcp.bykaranteli.com as a custom connector in any MCP-capable assistant. Same 50 tools, nothing to install. Without a key it runs on the shared Free pool; a connector header with your account key, x-api-key: bk_... (claude.ai custom connectors) or 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

Tool	What it answers
get_market_indices	"What is the Fear & Greed index today?", "What is BTC dominance right now?"
get_funding_heatmap	"What are funding rates right now?", "What is SOL's funding?"
get_funding_arbitrage	"Any funding arb opportunities?", "Best venue to long/short BTC for carry?"
get_pressure_scores	"Which coins are over-leveraged / crowded right now?"
get_top_movers	"Biggest OI spikes today?", "Most extreme funding right now?"
get_liquidations	"How much was liquidated today?", "Did longs or shorts get flushed this week?"
get_liquidation_leaderboard	"What was the biggest liquidation today?", "When do liquidations cluster, Asia or US hours?"
get_insurance_funds	"How big is the Binance insurance fund?", "Did any exchange insurance fund shrink this week?"
get_tokenized_stocks	"How much tokenized Tesla exists onchain?", "Which tokenized stock trades furthest from the real share?", "Which price valued this wrapper's supply?" (price_source, totals.priced_by)
get_etf_flows	"Did the Bitcoin ETFs buy or sell yesterday?", "Cumulative ETH ETF inflow?"
get_cot_positioning	"Are hedge funds long or short Bitcoin?", "What did the COT report show?"
get_options_snapshot	"Where are the BTC option walls?", "What is DVOL / the zero-gamma level?"
get_coinbase_premium	"Are US investors buying Bitcoin?", "What does the basis trade pay?"
get_flow_toxicity	"Is toxic order flow building?", "What is BTC's VPIN right now?"
get_options_flow	"What are the big options players buying?", "Any block trades today?"
get_slippage	"How much slippage on a $1M market order?", "Which book is thinnest?"
get_fomc_impact	"What does BTC do on Fed days?", "When is the next FOMC meeting?"
get_liquidation_cascades	"What caused that flush?", "Who got liquidated this week?"
get_open_interest	"Is leverage entering the market?", "Are shorts building in XRP?"
get_psi_charge	"What liquidity state is the market in?", "Is parked money deploying?"
get_theme_indices	"Which crypto narrative is leading: AI, RWA, DePIN, memes, L2s, DeFi?"
get_factor_board	"Which indicators sit in an unusual band today, and what followed historically?"
get_venue_markets	"Total BTC open interest across exchanges?", "What is the DEX share of perp OI?", "Is USDT off peg anywhere?"
get_leverage_tiers	"How much leverage does Bybit allow on SOL?", "Which exchange has the highest max leverage for DOGE?", "Did any venue cut leverage on a coin this week?"
get_withdrawal_status	"Has KuCoin paused USDT withdrawals?", "Cheapest network to withdraw USDT from Gate?", "Which exchanges have withdrawals closed right now?"
get_venue_profile	"What do you record about Bybit?", "How many contracts does OKX list?", "Is HTX up, and what happened there this week?"
get_settlements	"What expires this week?", "When is the next BTC quarterly on OKX?", "At what price did the September future settle?"
get_borrow_rates	"What does it cost to borrow USDT on Binance?", "Cheapest venue to borrow ETH?", "Is stablecoin borrow spiking?"
get_fee_table	"What are Bitget's perp fees?", "Which exchange has the lowest taker fee?", "Did any venue change fees this week?"
get_lead_lag	"Does Coinbase or Binance move first?"
get_iv_surface	"What is BTC implied vol by expiry?", "Is downside protection expensive (skew)?"
get_whale_tape	"Are whales buying or selling right now?"
get_correlations	"How correlated is SOL to BTC over 30 days?"
get_new_listings	"Which perpetuals were listed this week, and where first?"
get_macro_liquidity	"What is the Fed balance sheet / RRP / stablecoin supply doing?"
get_network_health	"Bitcoin hashrate, difficulty, fees, mempool right now?"
get_tradfi_board	"TSLA perp funding rate? Which exchanges list NVDA perps? Is the stock session open?"
get_rsi_heatmap	"Which coins are oversold on the daily? BTC RSI on 4h and 1w?"
get_hl_whales	"Are Hyperliquid whales net long BTC? What did the biggest accounts just flip?"
get_positioning	"BTC long/short ratio on Binance? Are top traders net short ETH? CVD today?"
get_coverage	"Which exchanges are behind your liquidation totals? How fresh is the data?"
get_orderbook_depth	"Where is the biggest BTC bid wall? How deep is ETH within 2% on Coinbase vs Binance?"
get_jupiter_perps	"How much long vs short OI is on Jupiter SOL perps? Who topped Jupiter this week? What is the JLP APR?"
get_turkey_premium	"What do lira buyers pay for bitcoin above the world price? What is the Turkey Premium Index and its score right now? Which Turkish exchange is dearest? What is USDT/TRY against the official rate?"
get_data_proof	"Can I verify a ByKaranteli number was not changed later? Show the on-chain proof for BTC funding right now. Which Solana transaction sealed the newest epoch?"
get_cycle_indicators	"Has the Pi Cycle crossed? Mayer Multiple and Puell today?"
get_altseason	"Is it altseason?", "What is the altcoin season index?"
get_metric_context	"Is today's funding extreme historically?", "Where does this reading sit in its distribution?"
get_quantum_exposure	"How much Bitcoin is quantum-vulnerable?", "What is the P2PK exposure?"
get_liqmap	"Where are the BTC liquidation clusters?", "Where would leveraged longs get liquidated?"

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

Env var	Default	Purpose
BYKARANTELI_API_KEY	none	Account key (bk_...) sent as Authorization: Bearer. Free at https://bykaranteli.com/dashboard/api; required for programs from 2026-09-10
BYKARANTELI_BASE_URL	https://bykaranteli.com	Override the API host (testing only)

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

Plan	Price	Rate	Depth
Free API	$0	30 / min	public pages
Builder	$49 / mo	300 / min	member depth, x402 catalog included
Business	$149 / mo	1,200 / min	member depth, commercial licence, monthly bulk
Scale	$399 / mo	3,000 / min	member depth, derived redistribution, daily raw

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.