kwery-mcp 0.2.0

package/CHANGELOG.md

@@ -0,0 +1,7 @@
+# kwery-mcp
+
+## 0.2.0
+
+### Minor Changes
+
+- Initial release - MCP server and CLI for Kwery

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kwery
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,55 @@
+# kwery-mcp
+
+MCP server for [Kwery](https://kwery.xyz) — unified crypto and prediction market
+data across Polymarket, Kalshi, Hyperliquid, Binance, and Chainlink.
+
+30 tools. No setup beyond an API key.
+
+## Install
+
+Add to your Claude Code config:
+
+```bash
+claude mcp add kwery npx kwery-mcp@latest
+```
+
+Or add to `~/.claude.json` / Claude Desktop config manually:
+
+```json
+{
+  "mcpServers": {
+    "kwery": {
+      "command": "npx",
+      "args": ["-y", "kwery-mcp@latest"],
+      "env": {
+        "KWERY_API_KEY": "your_api_key_here"
+      }
+    }
+  }
+}
+```
+
+Get your API key at [kwery.xyz/dashboard](https://kwery.xyz/dashboard).
+
+## Tools (30)
+
+| Platform | Tools |
+|----------|-------|
+| Discovery | `kwery_sources` `kwery_limits` `kwery_status` |
+| Markets | `kwery_markets` `kwery_market` |
+| Polymarket | `polymarket_markets` `polymarket_market` `polymarket_candles` `polymarket_trades` `polymarket_snapshots` `polymarket_snapshot_at` |
+| Kalshi | `kalshi_markets` `kalshi_prices` `kalshi_orderbook` `kalshi_snapshots` `kalshi_snapshot_at` |
+| Hyperliquid | `hyperliquid_markets` `hyperliquid_candles` `hyperliquid_trades` `hyperliquid_funding` `hyperliquid_oi` `hyperliquid_snapshots` `hyperliquid_snapshot_at` |
+| Binance | `binance_candles` `chainlink_candles` `binance_ticker` `binance_flow` `binance_funding` `binance_oi` `binance_liquidations` |
+
+## Requirements
+
+- Node.js 20+
+- Kwery API key ([free tier available](https://kwery.xyz))
+
+## Links
+
+- [Full docs](https://kwery.xyz/docs/mcp)
+- [API reference](https://kwery-api.com/docs)
+- [GitHub](https://github.com/KweryAPI/kwery-agents)
+- [Pricing](https://kwery.xyz/pricing)

package/dist/client.d.ts

@@ -0,0 +1,6 @@
+export declare class KweryClient {
+    private apiKey;
+    constructor(apiKey?: string);
+    get<T = unknown>(path: string, params?: Record<string, string | number | boolean | undefined>): Promise<T>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAEA,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,CAAC,EAAE,MAAM;IASrB,GAAG,CAAC,CAAC,GAAG,OAAO,EACnB,IAAI,EAAE,MAAM,EACZ,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAM,GACjE,OAAO,CAAC,CAAC,CAAC;CAoCd"}

package/dist/client.js

@@ -0,0 +1,41 @@
+const BASE_URL = process.env.KWERY_BASE_URL ?? "https://kwery-api.com";
+export class KweryClient {
+    apiKey;
+    constructor(apiKey) {
+        const key = apiKey ?? process.env.KWERY_API_KEY;
+        if (!key)
+            throw new Error("KWERY_API_KEY is required. Get your API key from https://kwery.xyz/dashboard " +
+                "and set it as the KWERY_API_KEY environment variable.");
+        this.apiKey = key;
+    }
+    async get(path, params = {}) {
+        const url = new URL(path, BASE_URL);
+        Object.entries(params).forEach(([k, v]) => {
+            if (v !== undefined) {
+                url.searchParams.set(k, String(v));
+            }
+        });
+        const res = await fetch(url.toString(), {
+            headers: {
+                "X-API-Key": this.apiKey,
+                "User-Agent": "kwery-mcp/0.1.0",
+            },
+        });
+        if (!res.ok) {
+            const body = await res.json().catch(() => ({}));
+            const message = body?.detail || body?.message || res.statusText;
+            if (res.status === 403) {
+                throw new Error(`Plan upgrade required: ${message}. Upgrade at https://kwery.xyz/pricing`);
+            }
+            if (res.status === 429) {
+                throw new Error("Rate limit exceeded. Slow down requests or upgrade your plan.");
+            }
+            if (res.status === 401) {
+                throw new Error("Invalid or missing API key. Check your KWERY_API_KEY.");
+            }
+            throw new Error(`Kwery API error ${res.status}: ${message}`);
+        }
+        return res.json();
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,uBAAuB,CAAC;AAEvE,MAAM,OAAO,WAAW;IACd,MAAM,CAAS;IAEvB,YAAY,MAAe;QACzB,MAAM,GAAG,GAAG,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;QAChD,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,KAAK,CACvB,+EAA+E;gBAC/E,uDAAuD,CACxD,CAAC;QACF,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC;IACpB,CAAC;IAED,KAAK,CAAC,GAAG,CACP,IAAY,EACZ,SAAgE,EAAE;QAElE,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAEpC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE;YACxC,IAAI,CAAC,KAAK,SAAS,EAAE,CAAC;gBACpB,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;YACrC,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE;YACtC,OAAO,EAAE;gBACP,WAAW,EAAE,IAAI,CAAC,MAAM;gBACxB,YAAY,EAAE,iBAAiB;aAChC;SACF,CAAC,CAAC;QAEH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAChD,MAAM,OAAO,GAAI,IAAY,EAAE,MAAM,IAAK,IAAY,EAAE,OAAO,IAAI,GAAG,CAAC,UAAU,CAAC;YAElF,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBACvB,MAAM,IAAI,KAAK,CACb,0BAA0B,OAAO,wCAAwC,CAC1E,CAAC;YACJ,CAAC;YACD,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBACvB,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAC;YACnF,CAAC;YACD,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBACvB,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;YAC3E,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,mBAAmB,GAAG,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC,CAAC;QAC/D,CAAC;QAED,OAAO,GAAG,CAAC,IAAI,EAAO,CAAC;IACzB,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { server } from "./server.js";
+const transport = new StdioServerTransport();
+await server.connect(transport);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,125 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { KweryClient } from "./client.js";
+export declare const ALL_TOOLS: ({
+    name: string;
+    description: string;
+    inputSchema: import("zod").ZodObject<{}, "strip", import("zod").ZodTypeAny, {}, {}>;
+    handler: (_params: {}, client: KweryClient) => Promise<unknown>;
+} | {
+    name: string;
+    description: string;
+    inputSchema: import("zod").ZodObject<{
+        limit: import("zod").ZodDefault<import("zod").ZodNumber>;
+    }, "strip", import("zod").ZodTypeAny, {
+        limit: number;
+    }, {
+        limit?: number | undefined;
+    }>;
+    handler: (params: {
+        limit?: number;
+    }, client: KweryClient) => Promise<unknown>;
+} | {
+    name: string;
+    description: string;
+    inputSchema: import("zod").ZodObject<{
+        identifier: import("zod").ZodString;
+    }, "strip", import("zod").ZodTypeAny, {
+        identifier: string;
+    }, {
+        identifier: string;
+    }>;
+    handler: (params: {
+        identifier: string;
+    }, client: KweryClient) => Promise<unknown>;
+} | {
+    name: string;
+    description: string;
+    inputSchema: import("zod").ZodEffects<import("zod").ZodObject<{
+        symbol: import("zod").ZodEnum<["BTC", "ETH", "SOL", "XRP"]>;
+        time: import("zod").ZodOptional<import("zod").ZodString>;
+        series: import("zod").ZodOptional<import("zod").ZodEnum<["15m", "daily"]>>;
+        interval: import("zod").ZodOptional<import("zod").ZodEnum<["5m", "15m", "1h", "4h", "24h"]>>;
+    }, "strip", import("zod").ZodTypeAny, {
+        symbol: "BTC" | "ETH" | "SOL" | "XRP";
+        interval?: "5m" | "15m" | "1h" | "4h" | "24h" | undefined;
+        time?: string | undefined;
+        series?: "15m" | "daily" | undefined;
+    }, {
+        symbol: "BTC" | "ETH" | "SOL" | "XRP";
+        interval?: "5m" | "15m" | "1h" | "4h" | "24h" | undefined;
+        time?: string | undefined;
+        series?: "15m" | "daily" | undefined;
+    }>, {
+        symbol: "BTC" | "ETH" | "SOL" | "XRP";
+        interval?: "5m" | "15m" | "1h" | "4h" | "24h" | undefined;
+        time?: string | undefined;
+        series?: "15m" | "daily" | undefined;
+    }, {
+        symbol: "BTC" | "ETH" | "SOL" | "XRP";
+        interval?: "5m" | "15m" | "1h" | "4h" | "24h" | undefined;
+        time?: string | undefined;
+        series?: "15m" | "daily" | undefined;
+    }>;
+    handler: (params: any, client: KweryClient) => Promise<unknown>;
+} | {
+    name: string;
+    description: string;
+    inputSchema: import("zod").ZodEffects<import("zod").ZodObject<{
+        symbol: import("zod").ZodEnum<["BTC", "ETH", "SOL", "XRP"]>;
+        time: import("zod").ZodOptional<import("zod").ZodString>;
+        interval: import("zod").ZodOptional<import("zod").ZodString>;
+    }, "strip", import("zod").ZodTypeAny, {
+        symbol: "BTC" | "ETH" | "SOL" | "XRP";
+        interval?: string | undefined;
+        time?: string | undefined;
+    }, {
+        symbol: "BTC" | "ETH" | "SOL" | "XRP";
+        interval?: string | undefined;
+        time?: string | undefined;
+    }>, {
+        symbol: "BTC" | "ETH" | "SOL" | "XRP";
+        interval?: string | undefined;
+        time?: string | undefined;
+    }, {
+        symbol: "BTC" | "ETH" | "SOL" | "XRP";
+        interval?: string | undefined;
+        time?: string | undefined;
+    }>;
+    handler: (params: any, client: KweryClient) => Promise<unknown>;
+})[];
+export declare function createServer(): Server;
+export declare const server: Server<{
+    method: string;
+    params?: {
+        [x: string]: unknown;
+        _meta?: {
+            [x: string]: unknown;
+            progressToken?: string | number | undefined;
+            "io.modelcontextprotocol/related-task"?: {
+                taskId: string;
+            } | undefined;
+        } | undefined;
+    } | undefined;
+}, {
+    method: string;
+    params?: {
+        [x: string]: unknown;
+        _meta?: {
+            [x: string]: unknown;
+            progressToken?: string | number | undefined;
+            "io.modelcontextprotocol/related-task"?: {
+                taskId: string;
+            } | undefined;
+        } | undefined;
+    } | undefined;
+}, {
+    [x: string]: unknown;
+    _meta?: {
+        [x: string]: unknown;
+        progressToken?: string | number | undefined;
+        "io.modelcontextprotocol/related-task"?: {
+            taskId: string;
+        } | undefined;
+    } | undefined;
+}>;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAMnE,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAQ1C,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;aAkCG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA3BxB,CAAC;AAEF,wBAAgB,YAAY,IAAI,MAAM,CAuCrC;AAED,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAAiB,CAAC"}

package/dist/server.js

@@ -0,0 +1,54 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { zodToJsonSchema } from "zod-to-json-schema";
+import { KweryClient } from "./client.js";
+import { discoveryTools } from "./tools/discovery.js";
+import { marketTools } from "./tools/markets.js";
+import { polymarketTools } from "./tools/polymarket.js";
+import { kalshiTools } from "./tools/kalshi.js";
+import { hyperliquidTools } from "./tools/hyperliquid.js";
+import { binanceTools } from "./tools/binance.js";
+export const ALL_TOOLS = [
+    ...discoveryTools,
+    ...marketTools,
+    ...polymarketTools,
+    ...kalshiTools,
+    ...hyperliquidTools,
+    ...binanceTools,
+];
+export function createServer() {
+    const s = new Server({ name: "kwery-mcp", version: "0.1.0" }, { capabilities: { tools: {} } });
+    s.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools: ALL_TOOLS.map((t) => ({
+            name: t.name,
+            description: t.description,
+            inputSchema: zodToJsonSchema(t.inputSchema),
+        })),
+    }));
+    s.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const tool = ALL_TOOLS.find((t) => t.name === request.params.name);
+        if (!tool) {
+            return {
+                content: [{ type: "text", text: `Unknown tool: ${request.params.name}` }],
+                isError: true,
+            };
+        }
+        try {
+            const params = tool.inputSchema.parse(request.params.arguments ?? {});
+            const client = new KweryClient();
+            const result = await tool.handler(params, client);
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: `Error: ${err.message}` }],
+                isError: true,
+            };
+        }
+    });
+    return s;
+}
+export const server = createServer();
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/dist/tools/binance.d.ts

@@ -0,0 +1,27 @@
+import { z } from "zod";
+import { KweryClient } from "../client.js";
+export declare const binanceTools: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        limit: z.ZodDefault<z.ZodNumber>;
+        after: z.ZodOptional<z.ZodString>;
+        start: z.ZodOptional<z.ZodString>;
+        end: z.ZodOptional<z.ZodString>;
+        symbol: z.ZodEnum<["BTC", "ETH", "SOL", "XRP"]>;
+    }, "strip", z.ZodTypeAny, {
+        symbol: "BTC" | "ETH" | "SOL" | "XRP";
+        limit: number;
+        after?: string | undefined;
+        start?: string | undefined;
+        end?: string | undefined;
+    }, {
+        symbol: "BTC" | "ETH" | "SOL" | "XRP";
+        limit?: number | undefined;
+        after?: string | undefined;
+        start?: string | undefined;
+        end?: string | undefined;
+    }>;
+    handler: (params: any, client: KweryClient) => Promise<unknown>;
+}[];
+//# sourceMappingURL=binance.d.ts.map

package/dist/tools/binance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binance.d.ts","sourceRoot":"","sources":["../../src/tools/binance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAG3C,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;sBA8EG,GAAG,UAAU,WAAW;GAoCnD,CAAC"}

package/dist/tools/binance.js

@@ -0,0 +1,111 @@
+import { z } from "zod";
+import { SymbolSchema, IntervalSchema, DateRangeSchema } from "../types.js";
+export const binanceTools = [
+    {
+        name: "binance_candles",
+        description: "Fetch OHLCV candle history from Binance spot or futures. " +
+            "source='binance' for spot, 'binance_futures' for perpetuals. " +
+            "Tier: Free 14d/15m+ · Pro 60d/5m+ · Business 90d/1s.",
+        inputSchema: z.object({
+            symbol: SymbolSchema,
+            interval: IntervalSchema,
+            source: z.enum(["binance", "binance_futures"]).default("binance"),
+            ...DateRangeSchema,
+            limit: z.number().int().min(1).max(10000).default(500),
+            after: z.string().optional(),
+        }),
+        handler: async (params, client) => {
+            return client.get("/v1/candles", params);
+        },
+    },
+    {
+        name: "chainlink_candles",
+        description: "Fetch OHLCV price feed data from Chainlink oracles. " +
+            "Useful for oracle lag analysis against Polymarket/Kalshi markets.",
+        inputSchema: z.object({
+            symbol: SymbolSchema,
+            interval: IntervalSchema,
+            ...DateRangeSchema,
+            limit: z.number().int().min(1).max(10000).default(500),
+            after: z.string().optional(),
+        }),
+        handler: async (params, client) => {
+            return client.get("/v1/candles", { source: "chainlink", ...params });
+        },
+    },
+    {
+        name: "binance_ticker",
+        description: "Fetch 1-second best bid/ask ticker snapshots. Requires Pro plan. Cost: 50 base + 5/row.",
+        inputSchema: z.object({
+            symbol: SymbolSchema,
+            source: z.enum(["binance", "binance_futures"]).default("binance"),
+            start: z.string().datetime({ offset: true }).optional(),
+            end: z.string().datetime({ offset: true }).optional(),
+            limit: z.number().int().min(1).max(3600).default(60),
+            after: z.string().optional(),
+        }),
+        handler: async (params, client) => {
+            return client.get("/v1/ticker", params);
+        },
+    },
+    {
+        name: "binance_flow",
+        description: "Fetch time-bucketed directional buy/sell pressure from Binance spot. " +
+            "buy_ratio > 0.5 = net buying pressure. Tier: Free 7d · Pro 6mo · Business full.",
+        inputSchema: z.object({
+            symbol: SymbolSchema,
+            interval: z.enum(["5m", "15m", "1h", "4h", "24h"]),
+            ...DateRangeSchema,
+            limit: z.number().int().min(1).max(5000).default(500),
+            after: z.string().optional(),
+        }),
+        handler: async (params, client) => {
+            return client.get("/v1/flow", params);
+        },
+    },
+    {
+        name: "binance_funding",
+        description: "Fetch perpetual funding rate history from Binance futures. " +
+            "Funding every 8h. Annualized = rate × 3 × 365. Tier: Free 7d · Pro 6mo · Business full.",
+        inputSchema: z.object({
+            symbol: SymbolSchema,
+            ...DateRangeSchema,
+            limit: z.number().int().min(1).max(5000).default(500),
+            after: z.string().optional(),
+        }),
+        handler: async (params, client) => {
+            return client.get("/v1/funding", { source: "binance_futures", ...params });
+        },
+    },
+    {
+        name: "binance_oi",
+        description: "Fetch open interest history from Binance futures. Tier: Free 7d · Pro 6mo · Business full.",
+        inputSchema: z.object({
+            symbol: SymbolSchema,
+            interval: IntervalSchema.default("1h"),
+            ...DateRangeSchema,
+            limit: z.number().int().min(1).max(5000).default(500),
+            after: z.string().optional(),
+        }),
+        handler: async (params, client) => {
+            return client.get("/v1/open-interest", { source: "binance_futures", ...params });
+        },
+    },
+    {
+        name: "binance_liquidations",
+        description: "Fetch Binance perpetual liquidation events. " +
+            "side='long' = forced sell. side='short' = forced buy. Tier: Free 24h · Pro 6mo · Business full.",
+        inputSchema: z.object({
+            symbol: SymbolSchema,
+            side: z.enum(["long", "short"]).optional(),
+            min_usd: z.number().optional(),
+            ...DateRangeSchema,
+            limit: z.number().int().min(1).max(10000).default(500),
+            after: z.string().optional(),
+        }),
+        handler: async (params, client) => {
+            return client.get("/v1/liquidations", params);
+        },
+    },
+];
+//# sourceMappingURL=binance.js.map

package/dist/tools/binance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"binance.js","sourceRoot":"","sources":["../../src/tools/binance.ts"],"names":[],"mappings":"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"}

package/dist/tools/discovery.d.ts

@@ -0,0 +1,22 @@
+import { z } from "zod";
+import { KweryClient } from "../client.js";
+export declare const discoveryTools: ({
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+    handler: (_params: {}, client: KweryClient) => Promise<unknown>;
+} | {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        limit: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        limit: number;
+    }, {
+        limit?: number | undefined;
+    }>;
+    handler: (params: {
+        limit?: number;
+    }, client: KweryClient) => Promise<unknown>;
+})[];
+//# sourceMappingURL=discovery.d.ts.map

package/dist/tools/discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../src/tools/discovery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,eAAO,MAAM,cAAc;;;;uBAuBE,EAAE,UAAU,WAAW;;;;;;;;;;;sBAaxB;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,UAAU,WAAW;IAIlE,CAAC"}

package/dist/tools/discovery.js

@@ -0,0 +1,40 @@
+import { z } from "zod";
+export const discoveryTools = [
+    {
+        name: "kwery_sources",
+        description: "List all available data sources, their supported symbols, intervals, endpoints, " +
+            "and tier requirements. Use this first to understand what data is available and " +
+            "what plan is required before making data requests.",
+        inputSchema: z.object({}),
+        handler: async (_params, client) => {
+            const [sources, symbols] = await Promise.all([
+                client.get("/v1/sources"),
+                client.get("/v1/symbols"),
+            ]);
+            return { sources, symbols };
+        },
+    },
+    {
+        name: "kwery_limits",
+        description: "Check the current API key's plan, remaining credits, rate limits, feature access " +
+            "(orderbook snapshots, 1s ticker, trade ticks, etc.), and snapshot history depth. " +
+            "Call this before large data pulls to ensure the plan supports the request.",
+        inputSchema: z.object({}),
+        handler: async (_params, client) => {
+            return client.get("/v1/limits");
+        },
+    },
+    {
+        name: "kwery_status",
+        description: "Check ingestion health for all data sources. Shows the last successful ingestion " +
+            "run per source, status, and rows inserted. Use to verify data freshness before " +
+            "running a backtest or analysis.",
+        inputSchema: z.object({
+            limit: z.number().int().min(1).max(200).default(50),
+        }),
+        handler: async (params, client) => {
+            return client.get("/v1/status", { limit: params.limit });
+        },
+    },
+];
+//# sourceMappingURL=discovery.js.map

package/dist/tools/discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.js","sourceRoot":"","sources":["../../src/tools/discovery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B;QACE,IAAI,EAAE,eAAe;QACrB,WAAW,EACT,kFAAkF;YAClF,iFAAiF;YACjF,oDAAoD;QACtD,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;QACzB,OAAO,EAAE,KAAK,EAAE,OAAW,EAAE,MAAmB,EAAE,EAAE;YAClD,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;gBAC3C,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC;gBACzB,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC;aAC1B,CAAC,CAAC;YACH,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;QAC9B,CAAC;KACF;IACD;QACE,IAAI,EAAE,cAAc;QACpB,WAAW,EACT,mFAAmF;YACnF,mFAAmF;YACnF,4EAA4E;QAC9E,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;QACzB,OAAO,EAAE,KAAK,EAAE,OAAW,EAAE,MAAmB,EAAE,EAAE;YAClD,OAAO,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAClC,CAAC;KACF;IACD;QACE,IAAI,EAAE,cAAc;QACpB,WAAW,EACT,mFAAmF;YACnF,iFAAiF;YACjF,iCAAiC;QACnC,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;SACpD,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,MAA0B,EAAE,MAAmB,EAAE,EAAE;YACjE,OAAO,MAAM,CAAC,GAAG,CAAC,YAAY,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QAC3D,CAAC;KACF;CACF,CAAC"}

package/dist/tools/hyperliquid.d.ts

@@ -0,0 +1,34 @@
+import { z } from "zod";
+import { KweryClient } from "../client.js";
+export declare const hyperliquidTools: ({
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+    handler: (_params: {}, client: KweryClient) => Promise<unknown>;
+} | {
+    name: string;
+    description: string;
+    inputSchema: z.ZodEffects<z.ZodObject<{
+        symbol: z.ZodEnum<["BTC", "ETH", "SOL", "XRP"]>;
+        time: z.ZodOptional<z.ZodString>;
+        interval: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        symbol: "BTC" | "ETH" | "SOL" | "XRP";
+        interval?: string | undefined;
+        time?: string | undefined;
+    }, {
+        symbol: "BTC" | "ETH" | "SOL" | "XRP";
+        interval?: string | undefined;
+        time?: string | undefined;
+    }>, {
+        symbol: "BTC" | "ETH" | "SOL" | "XRP";
+        interval?: string | undefined;
+        time?: string | undefined;
+    }, {
+        symbol: "BTC" | "ETH" | "SOL" | "XRP";
+        interval?: string | undefined;
+        time?: string | undefined;
+    }>;
+    handler: (params: any, client: KweryClient) => Promise<unknown>;
+})[];
+//# sourceMappingURL=hyperliquid.d.ts.map

package/dist/tools/hyperliquid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hyperliquid.d.ts","sourceRoot":"","sources":["../../src/tools/hyperliquid.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAG3C,eAAO,MAAM,gBAAgB;;;;uBAKA,EAAE,UAAU,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;sBA2FxB,GAAG,UAAU,WAAW;IAInD,CAAC"}