How do I install Bykaranteli?

Copy the http config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Bykaranteli need an API key?

No required environment variable is listed on this record.

What transport does Bykaranteli use?

Bykaranteli is reached over HTTP.

When was Bykaranteli last checked?

Last checked 2026-11-11. Crypto derivatives data: funding, OI, liquidations, options, ETF flows. Free account key required.

Bykaranteli MCP server

Power your agent

Add this server

The publisher's own URL. Not a PlugMCP endpoint.

Add to Cursor Add in Claude Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Server URL

https://mcp.bykaranteli.com/

The Claude button above opens Claude with the name and URL filled in. You still confirm it there.

shClaude Code

1claude mcp add --transport http com.bykaranteli-mcp https://mcp.bykaranteli.com/

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "com.bykaranteli-mcp": {4      "command": "npx",5      "args": [6        "-y",7        "mcp-remote",8        "https://mcp.bykaranteli.com/"9      ]10    }11  }12}

claude_desktop_config.json

Remote · HTTPPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Remote

Transport: http
Version: 1.1.3
Last checked

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

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.

68 read-only and account tools over the public JSON API of bykaranteli.com: the market data tools only read, and the alert and watchlist tools act on your own account through your key (Account tools). 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 and 15,000 a month, public depth), and the Builder, Business and Scale plans raise the rate and the monthly fair use and unlock member depth (LiqMap on seven timeframes, 5-minute series) and a monthly allowance of x402 catalog calls within each plan's history window (Plans and paid depth). 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. The same tools, nothing to install. Every tool call needs your account key (free at https://bykaranteli.com/dashboard/api); connecting and listing the tools work without one. The key travels one of three ways:

the request header x-api-key: bk_... (claude.ai custom connectors, Cursor, Claude Code);
the request header Authorization: Bearer bk_...;
the address https://mcp.bykaranteli.com/?key=bk_... for clients that cannot send headers (ChatGPT). Treat that address like a password and revoke the key if it leaks.

Or sign in with OAuth 2.1 where the client offers it (claude.ai custom connectors: Authentication, Sign in; ChatGPT connectors: OAuth): the client registers itself (RFC 7591, PKCE S256), you approve it once on bykaranteli.com and it runs on a key of your own account, which the Data and API page lists under connected apps. Discovery: https://mcp.bykaranteli.com/.well-known/oauth-protected-resource.

A free account covers the API and the hosted MCP on one monthly counter; Builder and above bring higher rates and member depth.

Step-by-step guide for beginners: https://bykaranteli.com/guide/connect

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?", "XRP ETF flows this week?"
`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?"

All market answers are JSON and carry a generatedAt timestamp, a source URL to the human-readable page and a provenance block: source_page, api_path, the answer's own generated_at, fetched_at, and when the answer carries them the venues behind the number, coverage (full, sampled or mixed), stale_venues and recorded_since, plus the proof page (https://bykaranteli.com/proof). A field the answer does not carry is left out, never filled in. Symbols accept both BTCUSDT and bare BTC.

Answers are sized for a model's context: a call without arguments returns a short first page (for example 30 rows, or the newest points of a series), never a whole board. Every shortened list is named in trimmed with field, returned, total and more, the parameter that returns the rest (symbol, coin, asset, limit, days, detail and the like); a filtered call keeps its full detail. One answer is capped at 100,000 characters; above that the tool says how to narrow the call.

Account tools (alerts and watchlist)

These tools read and change your own ByKaranteli account with the same key: the alert recipes that notify you on Telegram, email, push or webhook, and your watchlists. They never trade, move funds or touch another account.

Tool	What it does
`parse_alert_text`	Turns "BTC funding above 0.05%" or "tell me when ETH drops 5% in a day" into the exact recipe, with a confidence and what the text left open. Rule based; saves nothing, never invents a threshold.
`list_alert_recipes`	Lists your alert recipes with their conditions, scope, channels and when each last fired.
`create_alert_recipe`	Saves an alert recipe (writes to your account).
`delete_alert_recipe`	Deletes one of your alert recipes by id (writes to your account).
`list_watchlists`	Lists your watchlists and the symbols on each.
`add_watchlist_symbol`	Adds a symbol to your default list or the list you name (writes to your account).
`remove_watchlist_symbol`	Removes a symbol from a list (writes to your account).
`list_tracked_addresses`	Lists the Hyperliquid addresses you follow, with their last positions (reads your account).
`add_tracked_address`	Follows a Hyperliquid address for position alerts (writes to your account; Terminal and above).
`remove_tracked_address`	Stops following an address (writes to your account).

The write tools carry readOnlyHint: false (and destructiveHint: true for the two that remove something), so clients that ask before a change will ask.
How many recipes an account keeps follows its plan; past it, create_alert_recipe answers with the limit instead of saving.
Every call counts on the key's plan like any other request; writes are also rate limited per key, and each write is recorded on the account with the key that made it.
Recipes and watchlist changes show up at once on https://bykaranteli.com/dashboard/alerts and https://bykaranteli.com/dashboard/watchlist.
If a tool call answers 401, the body's error_description says what to send and the x-byk-mcp-auth header names the cause: key_required (no credential at all), key_unusable (a header or the address carried no key: the bk_... placeholder, an unset variable, a non-Bearer scheme, an OAuth token of the wrong shape), key_wrong_type (a prepaid bk_live_ key, which pays per call on /api/x402/* and does not open the MCP) or key_unrecognised (mistyped, expired or revoked). The WWW-Authenticate challenge starts the OAuth sign-in in clients that support it. This package forwards the REST body verbatim, so the same sentence reaches the model over stdio.

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). The key is sent to whatever host this names, so point it only at a server you trust.

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

Release notes per version: CHANGELOG.md.

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	Rate	Monthly	Depth
Free API	30 / min	15,000	public pages
Terminal	60 / min	150,000	public pages
Builder	300 / min	1,000,000 fair use	member depth, x402 catalog: 1,000 calls a month included over the last 90 days at up to 5,000 rows a call, summary series only, raw record routes paid per call
Business	1,200 / min	3,000,000 fair use	member depth, commercial licence, x402 catalog: 10,000 calls a month included over the last 365 days with raw records, monthly bulk exports over the same window
Scale	3,000 / min	10,000,000 fair use	member depth, derived redistribution, x402 catalog with no monthly ceiling over the whole archive with raw records, monthly bulk exports over the whole archive

Prices: https://bykaranteli.com/pricing

A Free or Terminal key past its monthly figure gets 429 until the month resets. A paid key past its fair use is never stopped: it answers at the Free rate (30 a minute) until the month resets, with x-quota-state: slow on every answer.

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, Business and Scale keys call those routes unpaid within the plan's catalog allowance (table above); each included call also counts as 10 requests of the monthly fair use. A call the plan does not include answers x402_allowance_used, history_window or raw_tier_required, and a route the plan does not carry answers tier_required (bulk exports start at Business): pay it with a prepaid key in x-api-key while the account key stays in Authorization: Bearer, or without the account key from a wallet.

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Bykaranteli?

Does Bykaranteli need an API key?

What transport does Bykaranteli use?

When was Bykaranteli last checked?

Documentation

bykaranteli-mcp

Hosted endpoint (no install)

Quick start

Claude Code

Claude Desktop

Cursor / other MCP clients

Tools

Account tools (alerts and watchlist)

Configuration

Data notes

Development

License

Plans and paid depth