@cryptoquant_official/mcp 0.0.4 → 0.0.6-alpha

package/dist/ai-sdk/prompts.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Default System Prompts for CryptoQuant AI SDK
+ *
+ * Pre-configured system prompts for common use cases.
+ *
+ * @example
+ * ```typescript
+ * import { CRYPTOQUANT_SYSTEM_PROMPT } from '@cryptoquant_official/mcp/ai-sdk'
+ *
+ * const result = streamText({
+ *   model: anthropic('claude-sonnet-4-20250514'),
+ *   system: CRYPTOQUANT_SYSTEM_PROMPT,
+ *   messages,
+ *   tools: createCryptoQuantTools({ cryptoquantApiKey: process.env.CRYPTOQUANT_API_KEY! }),
+ * })
+ * ```
+ */
+/**
+ * Default system prompt for CryptoQuant-powered AI assistants.
+ *
+ * Includes:
+ * - Role definition as crypto market analyst
+ * - Available tools and their purposes
+ * - Common metrics with brief descriptions
+ * - Step-by-step analysis workflow
+ * - Detailed interpretation thresholds
+ */
+export declare const CRYPTOQUANT_SYSTEM_PROMPT = "You are a crypto market analyst assistant powered by CryptoQuant on-chain data.\n\n## Available Tools\n1. **initialize** - Initialize CryptoQuant session (required before querying data)\n2. **discover_endpoints** - Find available data endpoints for specific assets/categories\n3. **query_data** - Fetch on-chain metrics with customizable parameters\n4. **describe_metric** - Get detailed metric explanations and thresholds\n5. **market_summary** - Get quick market status overview\n6. **trading_signal** - Calculate buy/sell/hold signals with confidence scores\n7. **whale_activity** - Track large holder movements and institutional flows\n\n## Common Metrics\n- **MVRV**: Market Value to Realized Value (valuation indicator)\n- **SOPR**: Spent Output Profit Ratio (profit/loss indicator)\n- **NUPL**: Net Unrealized Profit/Loss (sentiment indicator)\n- **Exchange Netflow**: Coins moving in/out of exchanges (accumulation/distribution)\n- **Funding Rate**: Perpetual futures funding (derivatives sentiment)\n\n## Analysis Workflow\n1. First initialize the session if not done\n2. Query the relevant metrics for the user's question\n3. Provide clear interpretation with context\n4. Mention key thresholds and what they mean\n5. Consider multiple metrics for confirmation\n\n\nYou are a crypto market analyst with access to CryptoQuant on-chain data.\n\n## Key Metrics Interpretation\n\n### Valuation (MVRV)\n- < 1.0: \uD83D\uDFE2 Undervalued (buy zone)\n- 1.0-2.5: \uD83D\uDFE1 Fair value\n- > 3.5: \uD83D\uDD34 Overheated (sell zone)\n\n### Profit Behavior (SOPR)\n- < 0.95: \uD83D\uDFE2 Capitulation (contrarian buy)\n- 0.95-1.05: \uD83D\uDFE1 Normal\n- > 1.10: \uD83D\uDD34 Heavy profit taking\n\n### Exchange Flows (Netflow)\n- < -1,000 BTC: \uD83D\uDFE2 Accumulation\n- \u00B11,000 BTC: \uD83D\uDFE1 Neutral\n- > +5,000 BTC: \uD83D\uDD34 Distribution\n\n### Funding Rate\n- < -0.03%: \uD83D\uDFE2 Shorts overcrowded\n- \u00B10.01%: \uD83D\uDFE1 Neutral\n- > 0.05%: \uD83D\uDD34 Longs overcrowded\n\n## Trading Signal Weights\n- MVRV: 30%\n- SOPR: 25%\n- Netflow: 25%\n- Funding: 20%\n\nScore > 70: BUY | 40-70: HOLD | < 40: SELL\n\n## Important Notes\n- No single metric is definitive - use multiple confirmations\n- Context matters - same values mean different things in bull vs bear\n- This is not financial advice - metrics are informational only\n\n";
+/**
+ * Minimal system prompt for CryptoQuant tools.
+ * Use this when you want a lighter prompt without detailed interpretation guidance.
+ */
+export declare const CRYPTOQUANT_MINIMAL_PROMPT = "You are a crypto market analyst assistant powered by CryptoQuant on-chain data.\n\nAvailable tools:\n1. initialize - Initialize CryptoQuant session (required before querying data)\n2. discover_endpoints - Find available data endpoints\n3. query_data - Fetch on-chain metrics\n4. describe_metric - Get metric explanations\n\nWhen analyzing data:\n1. First initialize the session if not done\n2. Query the relevant metrics\n3. Provide clear interpretation with context\n4. Mention key thresholds and what they mean\n";
+//# sourceMappingURL=prompts.d.ts.map

package/dist/ai-sdk/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/ai-sdk/prompts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH;;;;;;;;;GASG;AACH,eAAO,MAAM,yBAAyB,2zEA0BrC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,0BAA0B,ugBAatC,CAAC"}

package/dist/ai-sdk/prompts.js

@@ -0,0 +1,74 @@
+/**
+ * Default System Prompts for CryptoQuant AI SDK
+ *
+ * Pre-configured system prompts for common use cases.
+ *
+ * @example
+ * ```typescript
+ * import { CRYPTOQUANT_SYSTEM_PROMPT } from '@cryptoquant_official/mcp/ai-sdk'
+ *
+ * const result = streamText({
+ *   model: anthropic('claude-sonnet-4-20250514'),
+ *   system: CRYPTOQUANT_SYSTEM_PROMPT,
+ *   messages,
+ *   tools: createCryptoQuantTools({ cryptoquantApiKey: process.env.CRYPTOQUANT_API_KEY! }),
+ * })
+ * ```
+ */
+import { INTERPRETATION_SYSTEM_PROMPT } from "../shared/metrics-data.generated.js";
+/**
+ * Default system prompt for CryptoQuant-powered AI assistants.
+ *
+ * Includes:
+ * - Role definition as crypto market analyst
+ * - Available tools and their purposes
+ * - Common metrics with brief descriptions
+ * - Step-by-step analysis workflow
+ * - Detailed interpretation thresholds
+ */
+export const CRYPTOQUANT_SYSTEM_PROMPT = `You are a crypto market analyst assistant powered by CryptoQuant on-chain data.
+
+## Available Tools
+1. **initialize** - Initialize CryptoQuant session (required before querying data)
+2. **discover_endpoints** - Find available data endpoints for specific assets/categories
+3. **query_data** - Fetch on-chain metrics with customizable parameters
+4. **describe_metric** - Get detailed metric explanations and thresholds
+5. **market_summary** - Get quick market status overview
+6. **trading_signal** - Calculate buy/sell/hold signals with confidence scores
+7. **whale_activity** - Track large holder movements and institutional flows
+
+## Common Metrics
+- **MVRV**: Market Value to Realized Value (valuation indicator)
+- **SOPR**: Spent Output Profit Ratio (profit/loss indicator)
+- **NUPL**: Net Unrealized Profit/Loss (sentiment indicator)
+- **Exchange Netflow**: Coins moving in/out of exchanges (accumulation/distribution)
+- **Funding Rate**: Perpetual futures funding (derivatives sentiment)
+
+## Analysis Workflow
+1. First initialize the session if not done
+2. Query the relevant metrics for the user's question
+3. Provide clear interpretation with context
+4. Mention key thresholds and what they mean
+5. Consider multiple metrics for confirmation
+
+${INTERPRETATION_SYSTEM_PROMPT}
+`;
+/**
+ * Minimal system prompt for CryptoQuant tools.
+ * Use this when you want a lighter prompt without detailed interpretation guidance.
+ */
+export const CRYPTOQUANT_MINIMAL_PROMPT = `You are a crypto market analyst assistant powered by CryptoQuant on-chain data.
+
+Available tools:
+1. initialize - Initialize CryptoQuant session (required before querying data)
+2. discover_endpoints - Find available data endpoints
+3. query_data - Fetch on-chain metrics
+4. describe_metric - Get metric explanations
+
+When analyzing data:
+1. First initialize the session if not done
+2. Query the relevant metrics
+3. Provide clear interpretation with context
+4. Mention key thresholds and what they mean
+`;
+//# sourceMappingURL=prompts.js.map

package/dist/ai-sdk/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../src/ai-sdk/prompts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,4BAA4B,EAAE,MAAM,qCAAqC,CAAC;AAEnF;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;EAyBvC,4BAA4B;CAC7B,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG;;;;;;;;;;;;;CAazC,CAAC"}

package/dist/ai-sdk/schemas.d.ts

@@ -0,0 +1,66 @@
+/**
+ * JSON Schemas for CryptoQuant tools
+ *
+ * Uses AI SDK's jsonSchema instead of Zod to ensure Anthropic API compatibility.
+ * This avoids the "tools.0.custom.input_schema.type: Field required" error
+ * caused by zod version conflicts between packages.
+ *
+ * @see https://github.com/anthropics/claude-agent-sdk-typescript/issues/71
+ */
+/**
+ * Schema for initialize tool
+ */
+export declare const initializeSchema: import("ai").Schema<InitializeParams>;
+export type InitializeParams = {
+    api_key?: string;
+};
+/**
+ * Schema for discover_endpoints tool
+ */
+export declare const discoverEndpointsSchema: import("ai").Schema<DiscoverEndpointsParams>;
+export type DiscoverEndpointsParams = {
+    asset?: "btc" | "eth" | "alt" | "stablecoin" | "erc20" | "trx" | "xrp";
+    category?: string;
+    query?: string;
+};
+/**
+ * Schema for query_data tool
+ */
+export declare const queryDataSchema: import("ai").Schema<QueryDataParams>;
+export type QueryDataParams = {
+    endpoint: string;
+    window?: "hour" | "day" | "block";
+    limit?: number;
+    from?: string;
+    to?: string;
+};
+/**
+ * Schema for describe_metric tool
+ */
+export declare const describeMetricSchema: import("ai").Schema<DescribeMetricParams>;
+export type DescribeMetricParams = {
+    metric_id: string;
+};
+/**
+ * Schema for market_summary tool
+ */
+export declare const marketSummarySchema: import("ai").Schema<MarketSummaryParams>;
+export type MarketSummaryParams = {
+    asset?: "btc" | "eth";
+};
+/**
+ * Schema for trading_signal tool
+ */
+export declare const tradingSignalSchema: import("ai").Schema<TradingSignalParams>;
+export type TradingSignalParams = {
+    asset?: "btc" | "eth";
+};
+/**
+ * Schema for whale_activity tool
+ */
+export declare const whaleActivitySchema: import("ai").Schema<WhaleActivityParams>;
+export type WhaleActivityParams = {
+    asset?: "btc" | "eth";
+    timeframe?: "24h" | "7d" | "30d";
+};
+//# sourceMappingURL=schemas.d.ts.map

package/dist/ai-sdk/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/ai-sdk/schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;GAEG;AACH,eAAO,MAAM,gBAAgB,uCAU3B,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,uBAAuB,8CAmBlC,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAAG;IACpC,KAAK,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,YAAY,GAAG,OAAO,GAAG,KAAK,GAAG,KAAK,CAAC;IACvE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,sCA0B1B,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,OAAO,CAAC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;CACb,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB,2CAU/B,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG;IACjC,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,0CAU9B,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG;IAChC,KAAK,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;CACvB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,0CAU9B,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG;IAChC,KAAK,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;CACvB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,0CAe9B,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG;IAChC,KAAK,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;IACtB,SAAS,CAAC,EAAE,KAAK,GAAG,IAAI,GAAG,KAAK,CAAC;CAClC,CAAC"}

package/dist/ai-sdk/schemas.js

@@ -0,0 +1,136 @@
+/**
+ * JSON Schemas for CryptoQuant tools
+ *
+ * Uses AI SDK's jsonSchema instead of Zod to ensure Anthropic API compatibility.
+ * This avoids the "tools.0.custom.input_schema.type: Field required" error
+ * caused by zod version conflicts between packages.
+ *
+ * @see https://github.com/anthropics/claude-agent-sdk-typescript/issues/71
+ */
+import { jsonSchema } from "ai";
+/**
+ * Schema for initialize tool
+ */
+export const initializeSchema = jsonSchema({
+    type: "object",
+    properties: {
+        api_key: {
+            type: "string",
+            description: "CryptoQuant API key (optional if already provided in config)",
+        },
+    },
+    required: [],
+});
+/**
+ * Schema for discover_endpoints tool
+ */
+export const discoverEndpointsSchema = jsonSchema({
+    type: "object",
+    properties: {
+        asset: {
+            type: "string",
+            enum: ["btc", "eth", "alt", "stablecoin", "erc20", "trx", "xrp"],
+            description: "Asset to filter by (e.g., btc, eth)",
+        },
+        category: {
+            type: "string",
+            description: "Category filter (e.g., market-data, exchange-flows, network-data)",
+        },
+        query: {
+            type: "string",
+            description: "Search term to filter endpoints by name or path",
+        },
+    },
+    required: [],
+});
+/**
+ * Schema for query_data tool
+ */
+export const queryDataSchema = jsonSchema({
+    type: "object",
+    properties: {
+        endpoint: {
+            type: "string",
+            description: "API endpoint path (e.g., /v1/btc/market-data/mvrv)",
+        },
+        window: {
+            type: "string",
+            enum: ["hour", "day", "block"],
+            description: "Time window granularity",
+        },
+        limit: {
+            type: "number",
+            description: "Number of data points to return (default: 30, max: 1000)",
+        },
+        from: {
+            type: "string",
+            description: "Start date in ISO 8601 format (e.g., 2024-01-01)",
+        },
+        to: {
+            type: "string",
+            description: "End date in ISO 8601 format",
+        },
+    },
+    required: ["endpoint"],
+});
+/**
+ * Schema for describe_metric tool
+ */
+export const describeMetricSchema = jsonSchema({
+    type: "object",
+    properties: {
+        metric_id: {
+            type: "string",
+            description: "Metric ID to describe (e.g., mvrv, sopr, nupl, netflow)",
+        },
+    },
+    required: ["metric_id"],
+});
+/**
+ * Schema for market_summary tool
+ */
+export const marketSummarySchema = jsonSchema({
+    type: "object",
+    properties: {
+        asset: {
+            type: "string",
+            enum: ["btc", "eth"],
+            description: "Asset to analyze (default: btc)",
+        },
+    },
+    required: [],
+});
+/**
+ * Schema for trading_signal tool
+ */
+export const tradingSignalSchema = jsonSchema({
+    type: "object",
+    properties: {
+        asset: {
+            type: "string",
+            enum: ["btc", "eth"],
+            description: "Asset to analyze (default: btc)",
+        },
+    },
+    required: [],
+});
+/**
+ * Schema for whale_activity tool
+ */
+export const whaleActivitySchema = jsonSchema({
+    type: "object",
+    properties: {
+        asset: {
+            type: "string",
+            enum: ["btc", "eth"],
+            description: "Asset to analyze (default: btc)",
+        },
+        timeframe: {
+            type: "string",
+            enum: ["24h", "7d", "30d"],
+            description: "Timeframe for analysis (default: 24h)",
+        },
+    },
+    required: [],
+});
+//# sourceMappingURL=schemas.js.map

package/dist/ai-sdk/schemas.js.map

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

package/dist/ai-sdk/tools.d.ts

@@ -0,0 +1,165 @@
+/**
+ * CryptoQuant tools for Vercel AI SDK
+ *
+ * Usage with streamText:
+ * ```typescript
+ * import { createCryptoQuantTools } from '@cryptoquant_official/mcp/ai-sdk'
+ *
+ * const result = streamText({
+ *   model: anthropic('claude-sonnet-4-20250514'),
+ *   tools: createCryptoQuantTools({ cryptoquantApiKey: 'cq-...' }),
+ *   maxSteps: 5,
+ * })
+ * ```
+ */
+import type { CryptoQuantToolsConfig } from "./types.js";
+/**
+ * Create CryptoQuant tools for use with Vercel AI SDK's streamText/generateText
+ *
+ * @param config - Configuration including CryptoQuant API key
+ * @returns Object containing all CryptoQuant tools
+ *
+ * @example
+ * ```typescript
+ * // In your Next.js API route
+ * import { streamText } from 'ai'
+ * import { anthropic } from '@ai-sdk/anthropic'
+ * import { createCryptoQuantTools } from '@cryptoquant_official/mcp/ai-sdk'
+ *
+ * export async function POST(req: Request) {
+ *   const { messages } = await req.json()
+ *
+ *   const result = streamText({
+ *     model: anthropic('claude-sonnet-4-20250514'),
+ *     messages,
+ *     tools: createCryptoQuantTools({
+ *       cryptoquantApiKey: process.env.CRYPTOQUANT_API_KEY!,
+ *     }),
+ *     maxSteps: 5, // Allow multi-step tool execution
+ *   })
+ *
+ *   return result.toDataStreamResponse()
+ * }
+ * ```
+ */
+export declare function createCryptoQuantTools(config: CryptoQuantToolsConfig): {
+    /**
+     * Initialize CryptoQuant session
+     * Must be called before querying data
+     */
+    initialize: import("ai").Tool<import("ai").Schema<import("./schemas.js").InitializeParams>, import("./types.js").InitializeResult> & {
+        execute: (args: import("./schemas.js").InitializeParams, options: import("ai").ToolExecutionOptions) => PromiseLike<import("./types.js").InitializeResult>;
+    };
+    /**
+     * Discover available API endpoints
+     * Filter by asset (btc, eth) and/or category (market-data, exchange-flows)
+     */
+    discover_endpoints: import("ai").Tool<import("ai").Schema<import("./schemas.js").DiscoverEndpointsParams>, import("./types.js").DiscoverResult> & {
+        execute: (args: import("./schemas.js").DiscoverEndpointsParams, options: import("ai").ToolExecutionOptions) => PromiseLike<import("./types.js").DiscoverResult>;
+    };
+    /**
+     * Query on-chain data from CryptoQuant API
+     * Common endpoints: /v1/btc/market-data/mvrv, /v1/btc/market-indicator/sopr
+     */
+    query_data: import("ai").Tool<import("ai").Schema<import("./schemas.js").QueryDataParams>, import("./types.js").QueryResult> & {
+        execute: (args: import("./schemas.js").QueryDataParams, options: import("ai").ToolExecutionOptions) => PromiseLike<import("./types.js").QueryResult>;
+    };
+    /**
+     * Get explanation of a specific metric
+     * Includes thresholds and interpretation guidance
+     */
+    describe_metric: import("ai").Tool<import("ai").Schema<import("./schemas.js").DescribeMetricParams>, import("./types.js").DescribeResult> & {
+        execute: (args: import("./schemas.js").DescribeMetricParams, options: import("ai").ToolExecutionOptions) => PromiseLike<import("./types.js").DescribeResult>;
+    };
+    /**
+     * Quick market status summary
+     * Analyzes MVRV, SOPR, and exchange netflow to provide overall market sentiment
+     */
+    market_summary: import("ai").Tool<import("ai").Schema<import("./schemas.js").MarketSummaryParams>, import("./types.js").MarketSummaryResult> & {
+        execute: (args: import("./schemas.js").MarketSummaryParams, options: import("ai").ToolExecutionOptions) => PromiseLike<import("./types.js").MarketSummaryResult>;
+    };
+    /**
+     * Generate trading signal with confidence score
+     * Uses weighted metrics: MVRV (30%), SOPR (25%), Netflow (25%), Funding (20%)
+     */
+    trading_signal: import("ai").Tool<import("ai").Schema<import("./schemas.js").TradingSignalParams>, import("./types.js").TradingSignalResult> & {
+        execute: (args: import("./schemas.js").TradingSignalParams, options: import("ai").ToolExecutionOptions) => PromiseLike<import("./types.js").TradingSignalResult>;
+    };
+    /**
+     * Monitor whale (large holder) activity
+     * Tracks exchange flows and whale ratio
+     */
+    whale_activity: import("ai").Tool<import("ai").Schema<import("./schemas.js").WhaleActivityParams>, import("./types.js").WhaleActivityResult> & {
+        execute: (args: import("./schemas.js").WhaleActivityParams, options: import("ai").ToolExecutionOptions) => PromiseLike<import("./types.js").WhaleActivityResult>;
+    };
+};
+/**
+ * Pre-configured tools using CRYPTOQUANT_API_KEY environment variable
+ *
+ * Convenient for serverless environments where env vars are set.
+ * For explicit configuration, use createCryptoQuantTools() instead.
+ *
+ * @example
+ * ```typescript
+ * import { cryptoQuantTools } from '@cryptoquant_official/mcp/ai-sdk'
+ *
+ * const result = streamText({
+ *   model: anthropic('claude-sonnet-4-20250514'),
+ *   messages,
+ *   tools: cryptoQuantTools,
+ *   maxSteps: 5,
+ * })
+ * ```
+ */
+export declare const cryptoQuantTools: {
+    /**
+     * Initialize CryptoQuant session
+     * Must be called before querying data
+     */
+    initialize: import("ai").Tool<import("ai").Schema<import("./schemas.js").InitializeParams>, import("./types.js").InitializeResult> & {
+        execute: (args: import("./schemas.js").InitializeParams, options: import("ai").ToolExecutionOptions) => PromiseLike<import("./types.js").InitializeResult>;
+    };
+    /**
+     * Discover available API endpoints
+     * Filter by asset (btc, eth) and/or category (market-data, exchange-flows)
+     */
+    discover_endpoints: import("ai").Tool<import("ai").Schema<import("./schemas.js").DiscoverEndpointsParams>, import("./types.js").DiscoverResult> & {
+        execute: (args: import("./schemas.js").DiscoverEndpointsParams, options: import("ai").ToolExecutionOptions) => PromiseLike<import("./types.js").DiscoverResult>;
+    };
+    /**
+     * Query on-chain data from CryptoQuant API
+     * Common endpoints: /v1/btc/market-data/mvrv, /v1/btc/market-indicator/sopr
+     */
+    query_data: import("ai").Tool<import("ai").Schema<import("./schemas.js").QueryDataParams>, import("./types.js").QueryResult> & {
+        execute: (args: import("./schemas.js").QueryDataParams, options: import("ai").ToolExecutionOptions) => PromiseLike<import("./types.js").QueryResult>;
+    };
+    /**
+     * Get explanation of a specific metric
+     * Includes thresholds and interpretation guidance
+     */
+    describe_metric: import("ai").Tool<import("ai").Schema<import("./schemas.js").DescribeMetricParams>, import("./types.js").DescribeResult> & {
+        execute: (args: import("./schemas.js").DescribeMetricParams, options: import("ai").ToolExecutionOptions) => PromiseLike<import("./types.js").DescribeResult>;
+    };
+    /**
+     * Quick market status summary
+     * Analyzes MVRV, SOPR, and exchange netflow to provide overall market sentiment
+     */
+    market_summary: import("ai").Tool<import("ai").Schema<import("./schemas.js").MarketSummaryParams>, import("./types.js").MarketSummaryResult> & {
+        execute: (args: import("./schemas.js").MarketSummaryParams, options: import("ai").ToolExecutionOptions) => PromiseLike<import("./types.js").MarketSummaryResult>;
+    };
+    /**
+     * Generate trading signal with confidence score
+     * Uses weighted metrics: MVRV (30%), SOPR (25%), Netflow (25%), Funding (20%)
+     */
+    trading_signal: import("ai").Tool<import("ai").Schema<import("./schemas.js").TradingSignalParams>, import("./types.js").TradingSignalResult> & {
+        execute: (args: import("./schemas.js").TradingSignalParams, options: import("ai").ToolExecutionOptions) => PromiseLike<import("./types.js").TradingSignalResult>;
+    };
+    /**
+     * Monitor whale (large holder) activity
+     * Tracks exchange flows and whale ratio
+     */
+    whale_activity: import("ai").Tool<import("ai").Schema<import("./schemas.js").WhaleActivityParams>, import("./types.js").WhaleActivityResult> & {
+        execute: (args: import("./schemas.js").WhaleActivityParams, options: import("ai").ToolExecutionOptions) => PromiseLike<import("./types.js").WhaleActivityResult>;
+    };
+};
+//# sourceMappingURL=tools.d.ts.map

package/dist/ai-sdk/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/ai-sdk/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAsBH,OAAO,KAAK,EAAE,sBAAsB,EAAwB,MAAM,YAAY,CAAC;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,sBAAsB;IAMjE;;;OAGG;;;;IAUH;;;OAGG;;;;IAUH;;;OAGG;;;;IAUH;;;OAGG;;;;IAUH;;;OAGG;;;;IAUH;;;OAGG;;;;IAUH;;;OAGG;;;;EAUN;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,gBAAgB;IA/GzB;;;OAGG;;;;IAUH;;;OAGG;;;;IAUH;;;OAGG;;;;IAUH;;;OAGG;;;;IAUH;;;OAGG;;;;IAUH;;;OAGG;;;;IAUH;;;OAGG;;;;CAgCL,CAAC"}

package/dist/ai-sdk/tools.js

@@ -0,0 +1,152 @@
+/**
+ * CryptoQuant tools for Vercel AI SDK
+ *
+ * Usage with streamText:
+ * ```typescript
+ * import { createCryptoQuantTools } from '@cryptoquant_official/mcp/ai-sdk'
+ *
+ * const result = streamText({
+ *   model: anthropic('claude-sonnet-4-20250514'),
+ *   tools: createCryptoQuantTools({ cryptoquantApiKey: 'cq-...' }),
+ *   maxSteps: 5,
+ * })
+ * ```
+ */
+import { tool } from "ai";
+import { executeDescribeMetric, executeDiscoverEndpoints, executeInitialize, executeMarketSummary, executeQueryData, executeTradingSignal, executeWhaleActivity, } from "./execute.js";
+import { describeMetricSchema, discoverEndpointsSchema, initializeSchema, marketSummarySchema, queryDataSchema, tradingSignalSchema, whaleActivitySchema, } from "./schemas.js";
+/**
+ * Create CryptoQuant tools for use with Vercel AI SDK's streamText/generateText
+ *
+ * @param config - Configuration including CryptoQuant API key
+ * @returns Object containing all CryptoQuant tools
+ *
+ * @example
+ * ```typescript
+ * // In your Next.js API route
+ * import { streamText } from 'ai'
+ * import { anthropic } from '@ai-sdk/anthropic'
+ * import { createCryptoQuantTools } from '@cryptoquant_official/mcp/ai-sdk'
+ *
+ * export async function POST(req: Request) {
+ *   const { messages } = await req.json()
+ *
+ *   const result = streamText({
+ *     model: anthropic('claude-sonnet-4-20250514'),
+ *     messages,
+ *     tools: createCryptoQuantTools({
+ *       cryptoquantApiKey: process.env.CRYPTOQUANT_API_KEY!,
+ *     }),
+ *     maxSteps: 5, // Allow multi-step tool execution
+ *   })
+ *
+ *   return result.toDataStreamResponse()
+ * }
+ * ```
+ */
+export function createCryptoQuantTools(config) {
+    const context = {
+        cryptoquantApiKey: config.cryptoquantApiKey,
+    };
+    return {
+        /**
+         * Initialize CryptoQuant session
+         * Must be called before querying data
+         */
+        initialize: tool({
+            description: "Initialize CryptoQuant session. Must be called before querying data.",
+            parameters: initializeSchema,
+            execute: async (params) => {
+                return executeInitialize(params, context);
+            },
+        }),
+        /**
+         * Discover available API endpoints
+         * Filter by asset (btc, eth) and/or category (market-data, exchange-flows)
+         */
+        discover_endpoints: tool({
+            description: "Discover available API endpoints. Filter by asset (btc, eth, alt, stablecoin, erc20) and/or category (market-data, exchange-flows, network-data, etc.)",
+            parameters: discoverEndpointsSchema,
+            execute: async (params) => {
+                return executeDiscoverEndpoints(params);
+            },
+        }),
+        /**
+         * Query on-chain data from CryptoQuant API
+         * Common endpoints: /v1/btc/market-data/mvrv, /v1/btc/market-indicator/sopr
+         */
+        query_data: tool({
+            description: "Query on-chain data from CryptoQuant API. Common endpoints: /v1/btc/market-data/mvrv (MVRV ratio), /v1/btc/market-indicator/sopr (SOPR), /v1/btc/exchange-flows/netflow (Exchange netflow)",
+            parameters: queryDataSchema,
+            execute: async (params) => {
+                return executeQueryData(params, context);
+            },
+        }),
+        /**
+         * Get explanation of a specific metric
+         * Includes thresholds and interpretation guidance
+         */
+        describe_metric: tool({
+            description: "Get explanation of a specific metric including thresholds and interpretation guidance. Use when user asks 'what is X?' about metrics like MVRV, SOPR, NUPL, etc.",
+            parameters: describeMetricSchema,
+            execute: async (params) => {
+                return executeDescribeMetric(params);
+            },
+        }),
+        /**
+         * Quick market status summary
+         * Analyzes MVRV, SOPR, and exchange netflow to provide overall market sentiment
+         */
+        market_summary: tool({
+            description: "Get quick market status summary using key on-chain metrics (MVRV, SOPR, Netflow). Returns overall market sentiment with bullish/bearish signals.",
+            parameters: marketSummarySchema,
+            execute: async (params) => {
+                return executeMarketSummary(params, context);
+            },
+        }),
+        /**
+         * Generate trading signal with confidence score
+         * Uses weighted metrics: MVRV (30%), SOPR (25%), Netflow (25%), Funding (20%)
+         */
+        trading_signal: tool({
+            description: "Generate Buy/Sell/Hold trading signal with confidence score based on weighted on-chain metrics. Returns signal (STRONG BUY/BUY/HOLD/CAUTION/SELL) with detailed breakdown.",
+            parameters: tradingSignalSchema,
+            execute: async (params) => {
+                return executeTradingSignal(params, context);
+            },
+        }),
+        /**
+         * Monitor whale (large holder) activity
+         * Tracks exchange flows and whale ratio
+         */
+        whale_activity: tool({
+            description: "Monitor whale (large holder) activity including exchange flows and whale ratio. Identifies accumulation or distribution patterns by large players.",
+            parameters: whaleActivitySchema,
+            execute: async (params) => {
+                return executeWhaleActivity(params, context);
+            },
+        }),
+    };
+}
+/**
+ * Pre-configured tools using CRYPTOQUANT_API_KEY environment variable
+ *
+ * Convenient for serverless environments where env vars are set.
+ * For explicit configuration, use createCryptoQuantTools() instead.
+ *
+ * @example
+ * ```typescript
+ * import { cryptoQuantTools } from '@cryptoquant_official/mcp/ai-sdk'
+ *
+ * const result = streamText({
+ *   model: anthropic('claude-sonnet-4-20250514'),
+ *   messages,
+ *   tools: cryptoQuantTools,
+ *   maxSteps: 5,
+ * })
+ * ```
+ */
+export const cryptoQuantTools = createCryptoQuantTools({
+    cryptoquantApiKey: process.env.CRYPTOQUANT_API_KEY || "",
+});
+//# sourceMappingURL=tools.js.map

package/dist/ai-sdk/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/ai-sdk/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAE1B,OAAO,EACL,qBAAqB,EACrB,wBAAwB,EACxB,iBAAiB,EACjB,oBAAoB,EACpB,gBAAgB,EAChB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,cAAc,CAAC;AAGtB;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAA8B;IACnE,MAAM,OAAO,GAAyB;QACpC,iBAAiB,EAAE,MAAM,CAAC,iBAAiB;KAC5C,CAAC;IAEF,OAAO;QACL;;;WAGG;QACH,UAAU,EAAE,IAAI,CAAC;YACf,WAAW,EACT,sEAAsE;YACxE,UAAU,EAAE,gBAAgB;YAC5B,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;gBACxB,OAAO,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YAC5C,CAAC;SACF,CAAC;QAEF;;;WAGG;QACH,kBAAkB,EAAE,IAAI,CAAC;YACvB,WAAW,EACT,wJAAwJ;YAC1J,UAAU,EAAE,uBAAuB;YACnC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;gBACxB,OAAO,wBAAwB,CAAC,MAAM,CAAC,CAAC;YAC1C,CAAC;SACF,CAAC;QAEF;;;WAGG;QACH,UAAU,EAAE,IAAI,CAAC;YACf,WAAW,EACT,4LAA4L;YAC9L,UAAU,EAAE,eAAe;YAC3B,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;gBACxB,OAAO,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YAC3C,CAAC;SACF,CAAC;QAEF;;;WAGG;QACH,eAAe,EAAE,IAAI,CAAC;YACpB,WAAW,EACT,kKAAkK;YACpK,UAAU,EAAE,oBAAoB;YAChC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;gBACxB,OAAO,qBAAqB,CAAC,MAAM,CAAC,CAAC;YACvC,CAAC;SACF,CAAC;QAEF;;;WAGG;QACH,cAAc,EAAE,IAAI,CAAC;YACnB,WAAW,EACT,kJAAkJ;YACpJ,UAAU,EAAE,mBAAmB;YAC/B,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;gBACxB,OAAO,oBAAoB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YAC/C,CAAC;SACF,CAAC;QAEF;;;WAGG;QACH,cAAc,EAAE,IAAI,CAAC;YACnB,WAAW,EACT,4KAA4K;YAC9K,UAAU,EAAE,mBAAmB;YAC/B,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;gBACxB,OAAO,oBAAoB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YAC/C,CAAC;SACF,CAAC;QAEF;;;WAGG;QACH,cAAc,EAAE,IAAI,CAAC;YACnB,WAAW,EACT,oJAAoJ;YACtJ,UAAU,EAAE,mBAAmB;YAC/B,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;gBACxB,OAAO,oBAAoB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YAC/C,CAAC;SACF,CAAC;KACH,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,sBAAsB,CAAC;IACrD,iBAAiB,EAAE,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,EAAE;CACzD,CAAC,CAAC"}