# Bykaranteli MCP [Health: Active]

**Category:** 💰 Finance & Fintech  
**Repository:** https://github.com/bykarantelicom/bykaranteli-mcp  
**GitHub Stars:** 2  
**npm Downloads (last month):** 5301  
**Views:** 2  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/mcp-69

## Description
Live crypto data: funding rates, funding arbitrage, OI pressure, Fear & Greed. Free, no API key.

## Tools
Capabilities this server exposes over MCP:

- **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_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?"

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "bykaranteli-mcp": {
    "command": "npx",
    "args": ["-y","bykaranteli-mcp"]
  }
}
```

## Documentation & README

# 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](https://bykaranteli.com/developers). 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

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

### Claude Desktop

Add to `claude_desktop_config.json`:

```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](https://bykaranteli.com/risk-guide).

## Development

```bash
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.

