bykaranteli-mcp 0.30.0 → 0.30.2

package/README.md

@@ -2,15 +2,24 @@
 
 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.
+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 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, a monthly x402 catalog allowance). 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.
+assistant. Same 50 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.
+
+A free account covers the API and the hosted MCP on one monthly counter;
+Builder and above bring higher rates and member depth.
 
 ## Quick start
 
@@ -54,7 +63,7 @@ Requires Node.js 18 or newer.
 | `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?" |
+| `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?" |
@@ -126,16 +135,23 @@ Server: MIT. Data: personal and research use with attribution "ByKaranteli (byka
 
 ## 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 |
+| Plan | Price | Rate | Monthly | Depth |
+|---|---|---|---|---|
+| Free API | $0 | 30 / min | 15,000 | public pages |
+| Terminal | $29 / mo | 60 / min | 150,000 | public pages |
+| Builder | $49 / mo | 300 / min | 1,000,000 fair use | member depth, 1,000 x402 catalog calls a month |
+| Business | $149 / mo | 1,200 / min | 3,000,000 fair use | member depth, commercial licence, 10,000 x402 catalog calls a month, monthly bulk |
+| Scale | $399 / mo | 3,000 / min | 10,000,000 fair use | member depth, derived redistribution, x402 catalog with no ceiling, daily raw |
+
+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 and higher keys call those routes
-unpaid within their plan limits.
+<https://bykaranteli.com/api/x402>. Builder keys call those routes unpaid up to
+1,000 calls a month, Business up to 10,000, Scale with no ceiling; past the
+allowance a key pays per call like an anonymous agent or moves up a plan.

package/dist/tools.js

@@ -551,7 +551,7 @@ export function registerByKaranteliTools(server, options) {
     });
     server.registerTool("get_tokenized_stocks", {
         title: "Tokenized stocks onchain: supply, premium to the real share, DEX pools and exchange pairs",
-        description: "Call this when the user asks about tokenized stocks or stock tokens (xStocks, Ondo, Robinhood stock tokens, Coinbase tokenized stocks on Base, Binance bStocks, Backpack): how much of a stock exists onchain, which issuer or chain holds the most, whether a wrapper trades above or below the real share, which DEX pools or exchanges trade it. Returns the board ByKaranteli refreshes every 10 minutes: per underlying the reference share price and its session, each wrapper (issuer, chain, price, premium_pct against a fresh reference, DEX liquidity and 24h volume from admitted pools, supply in shares and dollars, holders, status), tokenized spot pairs on the exchanges the board lists, the perpetual futures cross, and totals (supply by issuer and chain, DEX volume, median premium). Wrappers come from issuer sources only, never from a name search.",
+        description: "Call this when the user asks about tokenized stocks or stock tokens (xStocks, Ondo, Robinhood stock tokens, Coinbase tokenized stocks on Base, Binance bStocks, Backpack): how much of a stock exists onchain, which issuer or chain holds the most, whether a wrapper trades above or below the real share, which DEX pools or exchanges trade it. Returns the board ByKaranteli refreshes every 10 minutes: per underlying the reference share price and its session, each wrapper (issuer, chain, price, premium_pct against a fresh reference, DEX liquidity and 24h volume from admitted pools, supply in shares and dollars, holders, status), tokenized spot pairs on the exchanges the board lists, the perpetual futures cross, and totals (supply by issuer and chain, DEX volume, median premium). Each wrapper's price_source names the price that valued its supply dollars (reference: the share's reference price; issuer_oracle: the issuer's own price for the token; wrapper: its own pool or exchange price; null: no dollars), and totals.priced_by counts the counted wrappers per level, unpriced included. Wrappers come from issuer sources only, never from a name search.",
         inputSchema: {
             underlying: z.string().regex(/^[A-Za-z0-9.]{1,16}$/).optional().describe("Stock ticker, e.g. TSLA; omit for the whole board."),
             issuer: z.enum(["xstocks", "robinhood", "coinbase", "bstocks", "ondo", "backpack", "gstocks"]).optional().describe("One issuer; omit for every issuer."),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bykaranteli-mcp",
-  "version": "0.30.0",
+  "version": "0.30.2",
   "description": "MCP server for live crypto derivatives data from bykaranteli.com: funding rates, funding arbitrage, open interest pressure, liquidations, options, ETF flows, Fear & Greed and BTC dominance. 50 read-only tools, free account key, paid depth via plans or x402.",
   "type": "module",
   "bin": {