cryptoquant-mcp 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 CryptoQuant
+
+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,183 @@
+# CryptoQuant MCP Server
+
+<p align="center">
+  <strong>On-Chain Analytics for Claude and AI Coding Agents</strong>
+</p>
+
+<p align="center">
+  <a href="#installation">Installation</a> •
+  <a href="#mcp-tools">MCP Tools</a> •
+  <a href="#authentication">Authentication</a>
+</p>
+
+---
+
+## What is this?
+
+CryptoQuant MCP Server brings on-chain analytics directly into your AI assistant:
+
+- **Natural language queries**: Ask in any language - "비트코인 가격 전망?" or "Is BTC overvalued?"
+- **Real-time metrics**: MVRV, SOPR, Exchange Flows, Funding Rates
+- **Market insights**: AI-powered interpretation of on-chain data
+- **Whale tracking**: Monitor large holder movements
+
+---
+
+## Installation
+
+### Quick Start (Claude Desktop, Cursor, etc.)
+
+**Step 1**: Add to your MCP config file:
+
+| App | Config File |
+|-----|-------------|
+| **Claude Desktop (Mac)** | `~/Library/Application Support/Claude/claude_desktop_config.json` |
+| **Claude Desktop (Windows)** | `%APPDATA%\Claude\claude_desktop_config.json` |
+| **Claude Code** | `~/.claude/mcp.json` or project `.mcp.json` |
+| **Cursor** | Project `.cursor/mcp.json` |
+
+```json
+{
+  "mcpServers": {
+    "cryptoquant": {
+      "command": "npx",
+      "args": ["-y", "cryptoquant-mcp"]
+    }
+  }
+}
+```
+
+**Step 2**: Restart your app
+
+**Step 3**: Call `initialize()` to verify connection. Done!
+
+### Local Development
+
+For contributors:
+
+```bash
+git clone https://github.com/CryptoQuantOfficial/cryptoquant-mcp.git
+cd cryptoquant-mcp
+npm install && npm run build
+```
+
+---
+
+## MCP Tools
+
+The MCP server provides these tools for API access:
+
+| Tool | Description |
+|------|-------------|
+| `initialize` | Start session with API key, returns plan info |
+| `discover_endpoints` | Browse 245+ available endpoints |
+| `get_endpoint_info` | Get endpoint parameter details |
+| `query_data` | Query raw API data |
+| `describe_metric` | Get metric descriptions and thresholds |
+| `list_assets` | List supported assets |
+| `reset_session` | Clear session (logout) |
+
+### Supported Assets
+
+BTC, ETH, ALT, Stablecoin, ERC20, TRX, XRP
+
+---
+
+## Natural Language Queries
+
+Ask questions in any language - Claude will route to the right metrics:
+
+| Query | Intent | Metric |
+|-------|--------|--------|
+| "비트코인 가격 전망이 어때?" | VALUATION | MVRV |
+| "Is BTC overvalued?" | VALUATION | MVRV |
+| "고래들 움직임 보여줘" | WHALE_ACTIVITY | whale-ratio |
+| "What's the funding rate?" | LEVERAGE | funding-rates |
+| "익절/손절 상황?" | PROFIT_BEHAVIOR | SOPR |
+
+---
+
+## Authentication
+
+### Option A. Environment Variable (Recommended)
+
+Add your API key to the MCP config:
+
+```json
+{
+  "mcpServers": {
+    "cryptoquant": {
+      "command": "npx",
+      "args": ["-y", "cryptoquant-mcp"],
+      "env": {
+        "CRYPTOQUANT_API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+
+### Option B. Direct Parameter
+
+Call `initialize()` with your API key:
+
+```
+initialize(api_key="your-api-key")
+```
+
+The key will be saved to `~/.cryptoquant/credentials` for future sessions.
+
+**Get your API key**: [https://cryptoquant.com/settings/api](https://cryptoquant.com/settings/api)
+
+### Managing Credentials
+
+```bash
+# Switch accounts
+reset_session(clear_stored=true)
+initialize(api_key="new-api-key")
+```
+
+---
+
+## Requirements
+
+| Component | Requirement |
+|-----------|-------------|
+| Node.js | v18+ |
+| API Access | [CryptoQuant API key](https://cryptoquant.com/settings/api) |
+
+---
+
+## License
+
+MIT License - see [LICENSE](LICENSE)
+
+---
+
+## Development
+
+### Setup
+
+After cloning the repository, install dependencies to set up git hooks:
+
+```bash
+npm install
+```
+
+This automatically configures [husky](https://typicode.github.io/husky/) for pre-commit hooks.
+
+### Pre-commit Hooks
+
+When committing changes to `src/`, ESLint runs automatically:
+
+- Lint check runs only when files in `src/` are staged
+- Commit is blocked if lint errors are found
+- Fix errors before committing: `npm run lint`
+
+---
+
+<p align="center">
+  <a href="https://cryptoquant.com">CryptoQuant</a> •
+  <a href="https://docs.cryptoquant.com">Docs</a> •
+  <a href="https://github.com/CryptoQuantOfficial/cryptoquant-mcp/issues">Issues</a>
+</p>

package/dist/auth/storage.d.ts

@@ -0,0 +1,11 @@
+export interface StoredCredentials {
+    api_key: string;
+    created_at: string;
+    validated_at: string;
+}
+export declare function getStoredApiKey(): string | null;
+export declare function saveApiKey(apiKey: string): void;
+export declare function updateValidatedAt(): void;
+export declare function clearCredentials(): void;
+export declare function getCredentialsPath(): string;
+//# sourceMappingURL=storage.d.ts.map

package/dist/auth/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/auth/storage.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,eAAe,IAAI,MAAM,GAAG,IAAI,CAQ/C;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAa/C;AAED,wBAAgB,iBAAiB,IAAI,IAAI,CASxC;AAED,wBAAgB,gBAAgB,IAAI,IAAI,CAMvC;AAED,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C"}

package/dist/auth/storage.js

@@ -0,0 +1,53 @@
+import { homedir } from "os";
+import { join } from "path";
+import { readFileSync, writeFileSync, mkdirSync, existsSync, unlinkSync, chmodSync } from "fs";
+const CREDENTIALS_DIR = join(homedir(), ".cryptoquant");
+const CREDENTIALS_FILE = join(CREDENTIALS_DIR, "credentials");
+export function getStoredApiKey() {
+    try {
+        if (!existsSync(CREDENTIALS_FILE))
+            return null;
+        const data = JSON.parse(readFileSync(CREDENTIALS_FILE, "utf-8"));
+        return data.api_key || null;
+    }
+    catch {
+        return null;
+    }
+}
+export function saveApiKey(apiKey) {
+    if (!existsSync(CREDENTIALS_DIR)) {
+        mkdirSync(CREDENTIALS_DIR, { recursive: true, mode: 0o700 });
+    }
+    const data = {
+        api_key: apiKey,
+        created_at: new Date().toISOString(),
+        validated_at: new Date().toISOString(),
+    };
+    writeFileSync(CREDENTIALS_FILE, JSON.stringify(data, null, 2), { encoding: "utf-8" });
+    chmodSync(CREDENTIALS_FILE, 0o600);
+}
+export function updateValidatedAt() {
+    try {
+        if (!existsSync(CREDENTIALS_FILE))
+            return;
+        const data = JSON.parse(readFileSync(CREDENTIALS_FILE, "utf-8"));
+        data.validated_at = new Date().toISOString();
+        writeFileSync(CREDENTIALS_FILE, JSON.stringify(data, null, 2), { encoding: "utf-8" });
+    }
+    catch {
+        // Validation timestamp update is non-critical
+    }
+}
+export function clearCredentials() {
+    try {
+        if (existsSync(CREDENTIALS_FILE))
+            unlinkSync(CREDENTIALS_FILE);
+    }
+    catch {
+        // Already deleted or inaccessible
+    }
+}
+export function getCredentialsPath() {
+    return CREDENTIALS_FILE;
+}
+//# sourceMappingURL=storage.js.map

package/dist/auth/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../../src/auth/storage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAC7B,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAE/F,MAAM,eAAe,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,cAAc,CAAC,CAAC;AACxD,MAAM,gBAAgB,GAAG,IAAI,CAAC,eAAe,EAAE,aAAa,CAAC,CAAC;AAQ9D,MAAM,UAAU,eAAe;IAC7B,IAAI,CAAC;QACH,IAAI,CAAC,UAAU,CAAC,gBAAgB,CAAC;YAAE,OAAO,IAAI,CAAC;QAC/C,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC,CAAC;QACjE,OAAO,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAAc;IACvC,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;QACjC,SAAS,CAAC,eAAe,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED,MAAM,IAAI,GAAsB;QAC9B,OAAO,EAAE,MAAM;QACf,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACpC,YAAY,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACvC,CAAC;IAEF,aAAa,CAAC,gBAAgB,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;IACtF,SAAS,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,IAAI,CAAC;QACH,IAAI,CAAC,UAAU,CAAC,gBAAgB,CAAC;YAAE,OAAO;QAC1C,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAsB,CAAC;QACtF,IAAI,CAAC,YAAY,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC7C,aAAa,CAAC,gBAAgB,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;IACxF,CAAC;IAAC,MAAM,CAAC;QACP,8CAA8C;IAChD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,IAAI,CAAC;QACH,IAAI,UAAU,CAAC,gBAAgB,CAAC;YAAE,UAAU,CAAC,gBAAgB,CAAC,CAAC;IACjE,CAAC;IAAC,MAAM,CAAC;QACP,kCAAkC;IACpC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,OAAO,gBAAgB,CAAC;AAC1B,CAAC"}

package/dist/cache/storage.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Cache storage operations for discovery response caching
+ */
+import { type DiscoveryCacheSchema, type MyDiscoveryRawResponse, type DiscoverySummaryData } from "./types.js";
+import type { UserPlan, PlanLimits, ApiRateLimit } from "../plan-limits.js";
+/**
+ * Get cache file path.
+ */
+export declare function getCacheFilePath(_apiUrl: string): string;
+/**
+ * Check if cache is still valid (not expired and version matches).
+ */
+export declare function isCacheValid(cache: DiscoveryCacheSchema, apiUrl: string, apiKeyPrefix: string): boolean;
+/**
+ * Read cache from file.
+ * Returns null if cache doesn't exist or is invalid JSON.
+ */
+export declare function readCache(apiUrl: string): DiscoveryCacheSchema | null;
+/**
+ * Write cache to file with secure permissions.
+ */
+export declare function writeCache(apiUrl: string, apiKey: string, rawResponse: MyDiscoveryRawResponse, parsed: {
+    limits: PlanLimits | null;
+    statics: string[];
+    apiRateLimit: ApiRateLimit | null;
+}, summary: DiscoverySummaryData, plan: UserPlan): void;
+/**
+ * Delete cache file.
+ */
+export declare function invalidateCache(apiUrl: string): void;
+/**
+ * Delete the cache file.
+ */
+export declare function clearAllCaches(): void;
+/**
+ * Calculate cache age in days.
+ */
+export declare function getCacheAgeDays(cache: DiscoveryCacheSchema): number;
+/**
+ * Get human-readable cache status string.
+ */
+export declare function getCacheStatus(cache: DiscoveryCacheSchema | null, fromCache: boolean): string;
+/**
+ * Get cache file path for user display.
+ */
+export declare function getCachePath(): string;
+//# sourceMappingURL=storage.d.ts.map

package/dist/cache/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/cache/storage.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EAG1B,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAK5E;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,oBAAoB,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAuBvG;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI,CAmBrE;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,sBAAsB,EACnC,MAAM,EAAE;IACN,MAAM,EAAE,UAAU,GAAG,IAAI,CAAC;IAC1B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC;CACnC,EACD,OAAO,EAAE,oBAAoB,EAC7B,IAAI,EAAE,QAAQ,GACb,IAAI,CA2BN;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAUpD;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAQrC;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,MAAM,CAKnE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,oBAAoB,GAAG,IAAI,EAAE,SAAS,EAAE,OAAO,GAAG,MAAM,CAM7F;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC"}

package/dist/cache/storage.js

@@ -0,0 +1,140 @@
+/**
+ * Cache storage operations for discovery response caching
+ */
+import { homedir } from "os";
+import { join } from "path";
+import { readFileSync, writeFileSync, mkdirSync, existsSync, unlinkSync, chmodSync } from "fs";
+import { CACHE_VERSION, CACHE_TTL_DAYS, } from "./types.js";
+const CACHE_DIR = join(homedir(), ".cryptoquant");
+const CACHE_FILE = join(CACHE_DIR, "discovery-cache.json");
+/**
+ * Get cache file path.
+ */
+export function getCacheFilePath(_apiUrl) {
+    return CACHE_FILE;
+}
+/**
+ * Check if cache is still valid (not expired and version matches).
+ */
+export function isCacheValid(cache, apiUrl, apiKeyPrefix) {
+    // Version check
+    if (cache.version !== CACHE_VERSION) {
+        return false;
+    }
+    // API URL must match
+    if (cache.metadata.api_url !== apiUrl) {
+        return false;
+    }
+    // API key prefix must match (detects account switch)
+    if (cache.metadata.api_key_prefix !== apiKeyPrefix) {
+        return false;
+    }
+    // TTL check
+    const expiresAt = new Date(cache.metadata.expires_at);
+    if (isNaN(expiresAt.getTime()) || expiresAt < new Date()) {
+        return false;
+    }
+    return true;
+}
+/**
+ * Read cache from file.
+ * Returns null if cache doesn't exist or is invalid JSON.
+ */
+export function readCache(apiUrl) {
+    const cachePath = getCacheFilePath(apiUrl);
+    try {
+        if (!existsSync(cachePath)) {
+            return null;
+        }
+        const data = JSON.parse(readFileSync(cachePath, "utf-8"));
+        // Basic structure validation
+        if (!data.version || !data.metadata || !data.raw_response || !data.summary) {
+            return null;
+        }
+        return data;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Write cache to file with secure permissions.
+ */
+export function writeCache(apiUrl, apiKey, rawResponse, parsed, summary, plan) {
+    // Ensure directory exists
+    if (!existsSync(CACHE_DIR)) {
+        mkdirSync(CACHE_DIR, { recursive: true, mode: 0o700 });
+    }
+    const now = new Date();
+    const expiresAt = new Date(now);
+    expiresAt.setDate(expiresAt.getDate() + CACHE_TTL_DAYS);
+    const cache = {
+        version: CACHE_VERSION,
+        metadata: {
+            api_url: apiUrl,
+            api_key_prefix: apiKey.slice(0, 8),
+            cached_at: now.toISOString(),
+            expires_at: expiresAt.toISOString(),
+            plan,
+        },
+        raw_response: rawResponse,
+        parsed,
+        summary,
+    };
+    const cachePath = getCacheFilePath(apiUrl);
+    writeFileSync(cachePath, JSON.stringify(cache, null, 2), { encoding: "utf-8" });
+    chmodSync(cachePath, 0o600);
+}
+/**
+ * Delete cache file.
+ */
+export function invalidateCache(apiUrl) {
+    const cachePath = getCacheFilePath(apiUrl);
+    try {
+        if (existsSync(cachePath)) {
+            unlinkSync(cachePath);
+        }
+    }
+    catch {
+        // Already deleted or inaccessible
+    }
+}
+/**
+ * Delete the cache file.
+ */
+export function clearAllCaches() {
+    try {
+        if (existsSync(CACHE_FILE)) {
+            unlinkSync(CACHE_FILE);
+        }
+    }
+    catch {
+        // Ignore errors
+    }
+}
+/**
+ * Calculate cache age in days.
+ */
+export function getCacheAgeDays(cache) {
+    const cachedAt = new Date(cache.metadata.cached_at);
+    const now = new Date();
+    const diffMs = now.getTime() - cachedAt.getTime();
+    return Math.floor(diffMs / (1000 * 60 * 60 * 24));
+}
+/**
+ * Get human-readable cache status string.
+ */
+export function getCacheStatus(cache, fromCache) {
+    if (!fromCache || !cache) {
+        return "fresh";
+    }
+    const days = getCacheAgeDays(cache);
+    return `cached (${days}d old)`;
+}
+/**
+ * Get cache file path for user display.
+ */
+export function getCachePath() {
+    return CACHE_DIR;
+}
+//# sourceMappingURL=storage.js.map

package/dist/cache/storage.js.map

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

package/dist/cache/summary.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Summary generation for cached discovery data
+ */
+import type { DiscoverySummaryData, MyDiscoveryRawResponse } from "./types.js";
+import type { PlanLimits } from "../plan-limits.js";
+/**
+ * Generate summary from parsed plan limits.
+ * Counts endpoints and organizes by asset/category.
+ */
+export declare function generateSummary(limits: PlanLimits | null, statics: string[]): DiscoverySummaryData;
+/**
+ * Extract raw response structure for caching.
+ * Only keeps necessary fields.
+ */
+export declare function extractRawResponse(apiResponse: Record<string, unknown>): MyDiscoveryRawResponse | null;
+//# sourceMappingURL=summary.d.ts.map

package/dist/cache/summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary.d.ts","sourceRoot":"","sources":["../../src/cache/summary.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAC/E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,oBAAoB,CAiElG;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,sBAAsB,GAAG,IAAI,CAqB/B"}

package/dist/cache/summary.js

@@ -0,0 +1,85 @@
+/**
+ * Summary generation for cached discovery data
+ */
+/**
+ * Generate summary from parsed plan limits.
+ * Counts endpoints and organizes by asset/category.
+ */
+export function generateSummary(limits, statics) {
+    const assetData = new Map();
+    // Count endpoints from limits
+    if (limits) {
+        for (const [asset, categories] of Object.entries(limits)) {
+            if (!assetData.has(asset)) {
+                assetData.set(asset, { endpoint_count: 0, categories: new Set() });
+            }
+            const data = assetData.get(asset);
+            for (const [category, metrics] of Object.entries(categories)) {
+                data.categories.add(category);
+                if (metrics) {
+                    data.endpoint_count += Object.keys(metrics).length;
+                }
+            }
+        }
+    }
+    // Count static endpoints (parse asset from path)
+    for (const staticPath of statics) {
+        const parts = staticPath.split("/");
+        if (parts.length >= 4) {
+            const asset = parts[2];
+            const category = parts[3];
+            if (!assetData.has(asset)) {
+                assetData.set(asset, { endpoint_count: 0, categories: new Set() });
+            }
+            const data = assetData.get(asset);
+            data.endpoint_count++;
+            data.categories.add(category);
+        }
+    }
+    // Build summary
+    const assets = [];
+    const categoryByAsset = {};
+    let totalEndpoints = 0;
+    for (const [asset, data] of assetData.entries()) {
+        assets.push({
+            name: asset,
+            endpoint_count: data.endpoint_count,
+            categories: Array.from(data.categories).sort(),
+        });
+        categoryByAsset[asset] = Array.from(data.categories).sort();
+        totalEndpoints += data.endpoint_count;
+    }
+    // Sort assets alphabetically
+    assets.sort((a, b) => a.name.localeCompare(b.name));
+    return {
+        total_endpoints: totalEndpoints,
+        assets,
+        category_by_asset: categoryByAsset,
+    };
+}
+/**
+ * Extract raw response structure for caching.
+ * Only keeps necessary fields.
+ */
+export function extractRawResponse(apiResponse) {
+    try {
+        const apiEndpoint = apiResponse.apiEndpoint;
+        const plan = apiResponse.plan;
+        const apiRateLimit = apiResponse.apiRateLimit;
+        if (!apiEndpoint || typeof apiEndpoint !== "object") {
+            return null;
+        }
+        return {
+            apiEndpoint: apiEndpoint,
+            plan: { name: plan?.name || "unknown" },
+            apiRateLimit: {
+                token: apiRateLimit?.token || 0,
+                window: apiRateLimit?.window || "day",
+            },
+        };
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=summary.js.map

package/dist/cache/summary.js.map

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

package/dist/cache/types.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Cache schema types for CryptoQuant discovery caching
+ */
+import type { UserPlan, ApiRateLimit, PlanLimits } from "../plan-limits.js";
+export declare const CACHE_VERSION = 1;
+export declare const CACHE_TTL_DAYS = 7;
+/**
+ * Raw API response structure from /my/discovery/endpoints
+ */
+export interface MyDiscoveryRawResponse {
+    apiEndpoint: Record<string, unknown>;
+    plan: {
+        name: string;
+    };
+    apiRateLimit: {
+        token: number;
+        window: string;
+    };
+}
+/**
+ * Summary data generated from the raw response
+ */
+export interface DiscoverySummaryData {
+    total_endpoints: number;
+    assets: Array<{
+        name: string;
+        endpoint_count: number;
+        categories: string[];
+    }>;
+    category_by_asset: Record<string, string[]>;
+}
+/**
+ * Cache metadata for validation
+ */
+export interface CacheMetadata {
+    api_url: string;
+    api_key_prefix: string;
+    cached_at: string;
+    expires_at: string;
+    plan: UserPlan;
+}
+/**
+ * Full cache schema stored in file
+ */
+export interface DiscoveryCacheSchema {
+    version: typeof CACHE_VERSION;
+    metadata: CacheMetadata;
+    raw_response: MyDiscoveryRawResponse;
+    parsed: {
+        limits: PlanLimits | null;
+        statics: string[];
+        apiRateLimit: ApiRateLimit | null;
+    };
+    summary: DiscoverySummaryData;
+}
+/**
+ * Compact response format for initialize() tool
+ */
+export interface CompactInitializeResponse {
+    success: boolean;
+    session: {
+        plan: UserPlan;
+        rate_limit: string;
+        cache_status: string;
+    };
+    scope: {
+        total_endpoints: number;
+        accessible: number;
+        assets: Record<string, {
+            endpoints: number;
+            categories: number;
+        }>;
+        note: string;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/cache/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/cache/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE5E,eAAO,MAAM,aAAa,IAAI,CAAC;AAC/B,eAAO,MAAM,cAAc,IAAI,CAAC;AAEhC;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACvB,YAAY,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CACjD;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,KAAK,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,cAAc,EAAE,MAAM,CAAC;QACvB,UAAU,EAAE,MAAM,EAAE,CAAC;KACtB,CAAC,CAAC;IACH,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,QAAQ,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,aAAa,CAAC;IAC9B,QAAQ,EAAE,aAAa,CAAC;IACxB,YAAY,EAAE,sBAAsB,CAAC;IACrC,MAAM,EAAE;QACN,MAAM,EAAE,UAAU,GAAG,IAAI,CAAC;QAC1B,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC;KACnC,CAAC;IACF,OAAO,EAAE,oBAAoB,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE;QACP,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,KAAK,EAAE;QACL,eAAe,EAAE,MAAM,CAAC;QACxB,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,MAAM,CACZ,MAAM,EACN;YACE,SAAS,EAAE,MAAM,CAAC;YAClB,UAAU,EAAE,MAAM,CAAC;SACpB,CACF,CAAC;QACF,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;CACH"}