@datadive-tools/mcp 0.1.0 → 0.3.0

package/README.md

@@ -95,6 +95,7 @@ niches, plus pagination metadata. If you don't, see Troubleshooting below.
 | `get_ranking_juice` | DataDive proprietary ranking-juice metric per competitor (current vs optimized listing). |
 | `list_rank_radars` | Paginated list of rank radars. Filter by `nicheId` or `status`. |
 | `get_rank_radar_data` | Historical keyword rankings for a rank radar within a `startDate`/`endDate` range. |
+| `get_asin_inventory_distribution` | Per-fulfillment-center sellable inventory for an ASIN. Requires `sellerId` from your Connections page. |
 
 Read-only. All data is scoped to the organization that owns the API key.
 

package/dist/index.js

@@ -5,7 +5,7 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 
 // src/config.ts
 var DEFAULT_BASE_URL = "https://api.datadive.tools";
-var KEY_HELP_URL = "https://app.datadive.tools/api-key";
+var KEY_HELP_URL = "https://2.datadive.tools/api-key";
 function loadConfig(env = process.env) {
   const apiKey = (env.DATADIVE_API_KEY ?? "").trim();
   if (!apiKey) {
@@ -25,7 +25,7 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { z } from "zod";
 
 // src/http/errors.ts
-var KEY_HELP_URL2 = "https://app.datadive.tools/api-key";
+var KEY_HELP_URL2 = "https://2.datadive.tools/api-key";
 var ApiError = class _ApiError extends Error {
   kind;
   status;
@@ -59,7 +59,7 @@ var ApiError = class _ApiError extends Error {
       return new _ApiError(
         "payment",
         402,
-        "Subscription is inactive or paused. Resume billing at https://app.datadive.tools to use the API.",
+        "Subscription is inactive or paused. Resume billing at https://2.datadive.tools to use the API.",
         body
       );
     }
@@ -99,8 +99,38 @@ function extractMessage(body) {
   return null;
 }
 
+// package.json
+var version = "0.3.0";
+
 // src/http/client.ts
-var PKG_VERSION = "0.1.0";
+var PKG_VERSION = version;
+var LATEST_VERSION_HEADER = "x-datadive-mcp-latest";
+var pendingUpgradeNotice = null;
+var hasWarned = false;
+function isNewerVersion(latest, current) {
+  const parse = (v) => v.split(/[-+]/)[0].split(".").map((n) => parseInt(n, 10) || 0);
+  const a = parse(latest);
+  const b = parse(current);
+  for (let i = 0; i < 3; i++) {
+    const da = a[i] ?? 0;
+    const db = b[i] ?? 0;
+    if (da !== db) return da > db;
+  }
+  return false;
+}
+function noteLatestVersion(latest) {
+  if (!latest || hasWarned) return;
+  if (isNewerVersion(latest, PKG_VERSION)) {
+    pendingUpgradeNotice = `A newer version of datadive-mcp is available (${latest}; you are running ${PKG_VERSION}). Update by reinstalling the latest from npm \u2014 e.g. \`npm install -g @datadive-tools/mcp@latest\` \u2014 or bump the @datadive-tools/mcp version in your MCP client config, then restart the client.`;
+  }
+}
+function takeUpgradeNotice() {
+  if (!pendingUpgradeNotice) return null;
+  const notice = pendingUpgradeNotice;
+  pendingUpgradeNotice = null;
+  hasWarned = true;
+  return notice;
+}
 var PAGINATION_KEYS = ["currentPage", "lastPage", "hasNext", "hasPrev", "pageSize", "total"];
 async function httpGet(ctx, path, query) {
   const url = buildUrl(ctx.config.baseUrl, path, query);
@@ -118,6 +148,7 @@ async function httpGet(ctx, path, query) {
     const msg = e instanceof Error ? e.message : String(e);
     throw new ApiError("network", 0, `Network error reaching ${url}: ${msg}`);
   }
+  noteLatestVersion(res.headers.get(LATEST_VERSION_HEADER));
   const text = await res.text();
   let body;
   try {
@@ -287,6 +318,32 @@ var getRankRadarDataTool = {
   }
 };
 
+// src/tools/get-asin-inventory-distribution.ts
+import { z as z7 } from "zod";
+var inputSchema7 = {
+  sellerId: z7.string().min(1).describe(
+    "Amazon seller account ID as connected to DataDive. Find it on the Connections page at https://2.datadive.tools \u2014 there is no MCP discovery tool for sellers yet."
+  ),
+  marketplace: z7.enum(["com", "ca", "co.uk", "com.mx", "in", "fr", "de", "es", "it", "co.jp"]).describe('Amazon marketplace code, e.g. "com" for amazon.com or "co.uk" for amazon.co.uk.'),
+  asin: z7.string().regex(/^[A-Z0-9]{10}$/, "ASIN must be 10 uppercase alphanumeric characters (e.g. B08XYZ1234).").describe(
+    "Amazon Standard Identification Number (10 uppercase alphanumeric characters, e.g. B08XYZ1234)."
+  )
+};
+var getAsinInventoryDistributionTool = {
+  name: "get_asin_inventory_distribution",
+  title: "Get Per-Fulfillment-Center Inventory Distribution for an ASIN",
+  description: "Use this when the user asks about inventory levels, stock by fulfillment center, or where their units are sitting across Amazon's fulfillment network for a specific ASIN. Requires the Amazon sellerId from the user's DataDive Connections page (https://2.datadive.tools), the marketplace code, and the ASIN. Returns totalSellableUnits and a per-FC `distribution` array (fc, state, availableStock, availableStockPercentage). `lastUpdatedAt` may be null when no successful inventory ingestion has occurred in the last 30 days.",
+  inputSchema: inputSchema7,
+  handler: async (args, ctx) => {
+    return await httpGet(
+      { config: ctx.config, toolName: "get_asin_inventory_distribution" },
+      `/v1/sellers/${encodeURIComponent(args.sellerId)}/marketplaces/${encodeURIComponent(
+        args.marketplace
+      )}/asins/${encodeURIComponent(args.asin)}/inventory`
+    );
+  }
+};
+
 // src/tools/index.ts
 var allTools = [
   listNichesTool,
@@ -294,7 +351,8 @@ var allTools = [
   getNicheCompetitorsTool,
   getRankingJuiceTool,
   listRankRadarsTool,
-  getRankRadarDataTool
+  getRankRadarDataTool,
+  getAsinInventoryDistributionTool
 ];
 
 // src/server.ts
@@ -314,14 +372,20 @@ function buildServer(config) {
       async (args) => {
         try {
           const data = await tool.handler(args, { config });
-          return {
-            content: [
-              {
-                type: "text",
-                text: JSON.stringify(data, null, 2)
-              }
-            ]
-          };
+          const content = [
+            {
+              type: "text",
+              text: JSON.stringify(data, null, 2)
+            }
+          ];
+          const notice = takeUpgradeNotice();
+          if (notice) {
+            content.push({
+              type: "text",
+              text: `\u26A0\uFE0F datadive-mcp update available \u2014 ${notice}`
+            });
+          }
+          return { content };
         } catch (err) {
           return {
             isError: true,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/config.ts","../src/server.ts","../src/tools/list-niches.ts","../src/http/errors.ts","../src/http/client.ts","../src/tools/get-niche-keywords.ts","../src/tools/get-niche-competitors.ts","../src/tools/get-ranking-juice.ts","../src/tools/list-rank-radars.ts","../src/types/api.ts","../src/tools/get-rank-radar-data.ts","../src/tools/index.ts"],"sourcesContent":["/**\n * Entry point for the datadive-mcp stdio binary.\n *\n * Wired via package.json#bin -> dist/index.js so `npx -y @datadive-tools/mcp` runs it.\n * The shebang is added at build time by tsup.config.ts (banner.js).\n */\n\nimport { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\";\nimport { loadConfig } from \"./config.js\";\nimport { buildServer } from \"./server.js\";\n\nasync function main() {\n  let config;\n  try {\n    config = loadConfig();\n  } catch (err) {\n    // Config errors (e.g. missing API key) are user-facing; print to stderr and exit\n    // non-zero so the MCP client surfaces a real error rather than silently disconnecting.\n    const msg = err instanceof Error ? err.message : String(err);\n    process.stderr.write(`[datadive-mcp] ${msg}\\n`);\n    process.exit(1);\n  }\n\n  const server = buildServer(config);\n  const transport = new StdioServerTransport();\n  await server.connect(transport);\n}\n\nmain().catch((err) => {\n  const msg = err instanceof Error ? (err.stack ?? err.message) : String(err);\n  process.stderr.write(`[datadive-mcp] fatal: ${msg}\\n`);\n  process.exit(1);\n});\n","/**\n * Loads and validates the server's runtime configuration from environment.\n *\n * Required:\n *   DATADIVE_API_KEY        - your DataDive API key (generate at app.datadive.tools/api-key)\n *\n * Optional:\n *   DATADIVE_API_BASE_URL   - override the API base URL (defaults to https://api.datadive.tools)\n */\n\nexport interface Config {\n  apiKey: string;\n  baseUrl: string;\n}\n\nconst DEFAULT_BASE_URL = \"https://api.datadive.tools\";\nconst KEY_HELP_URL = \"https://app.datadive.tools/api-key\";\n\nexport function loadConfig(env: NodeJS.ProcessEnv = process.env): Config {\n  const apiKey = (env.DATADIVE_API_KEY ?? \"\").trim();\n  if (!apiKey) {\n    throw new Error(\n      `DATADIVE_API_KEY environment variable is required. Generate one at ${KEY_HELP_URL} ` +\n        `and add it to your MCP client config under env.DATADIVE_API_KEY.`,\n    );\n  }\n\n  const rawBase = (env.DATADIVE_API_BASE_URL ?? DEFAULT_BASE_URL).trim();\n  // Normalize: strip trailing slashes so we can append \"/v1/...\" paths cleanly.\n  const baseUrl = rawBase.replace(/\\/+$/, \"\");\n\n  return { apiKey, baseUrl };\n}\n","/**\n * Builds the MCP server: registers each tool from the registry with the SDK.\n *\n * Error handling: if a tool handler throws (most commonly an ApiError from the\n * HTTP client), we surface the message back through MCP as a tool-level error\n * (`isError: true`). The LLM sees the message and can react — e.g. tell the\n * user to regenerate their API key on a 401.\n */\n\nimport { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport type { Config } from \"./config.js\";\nimport { allTools } from \"./tools/index.js\";\nimport { ApiError } from \"./http/errors.js\";\nimport { PKG_VERSION } from \"./http/client.js\";\n\nexport function buildServer(config: Config): McpServer {\n  const server = new McpServer({\n    name: \"datadive\",\n    version: PKG_VERSION,\n  });\n\n  for (const tool of allTools) {\n    server.registerTool(\n      tool.name,\n      {\n        title: tool.title,\n        description: tool.description,\n        inputSchema: tool.inputSchema,\n      },\n      async (args: Record<string, unknown>) => {\n        try {\n          const data = await tool.handler(args, { config });\n          return {\n            content: [\n              {\n                type: \"text\" as const,\n                text: JSON.stringify(data, null, 2),\n              },\n            ],\n          };\n        } catch (err) {\n          return {\n            isError: true,\n            content: [\n              {\n                type: \"text\" as const,\n                text: err instanceof ApiError ? err.message : err instanceof Error ? err.message : String(err),\n              },\n            ],\n          };\n        }\n      },\n    );\n  }\n\n  return server;\n}\n","import { z } from \"zod\";\nimport { httpGet } from \"../http/client.js\";\nimport type { NicheList } from \"../types/api.js\";\nimport type { ToolDefinition } from \"./types.js\";\n\nconst inputSchema = {\n  currentPage: z\n    .number()\n    .int()\n    .min(1)\n    .optional()\n    .describe(\"Page number, 1-indexed. Defaults to 1.\"),\n  pageSize: z\n    .number()\n    .int()\n    .min(1)\n    .max(100)\n    .optional()\n    .describe(\"Items per page (max 100). Defaults to 20.\"),\n};\n\nexport const listNichesTool: ToolDefinition<typeof inputSchema> = {\n  name: \"list_niches\",\n  title: \"List DataDive Niches\",\n  description:\n    \"Use this first when the user asks about their niches, or to find a `nicheId` for use with \" +\n    \"`get_niche_keywords`, `get_niche_competitors`, or `get_ranking_juice`. \" +\n    \"Retrieves a paginated list of Niches. Each Niche represents a market segment or product \" +\n    \"category being tracked. Returns nicheId, heroKeyword, nicheLabel, marketplace (com/uk/de/...), \" +\n    \"and latestResearchDate per niche, plus pagination metadata (currentPage, pageSize, total, \" +\n    \"lastPage, hasNext, hasPrev).\",\n  inputSchema,\n  handler: async (args, ctx) => {\n    return await httpGet<NicheList>(\n      { config: ctx.config, toolName: \"list_niches\" },\n      \"/v1/niches\",\n      { currentPage: args.currentPage, pageSize: args.pageSize },\n    );\n  },\n};\n","/**\n * Error mapping for the DataDive /v1 API.\n *\n * The MCP server is a thin HTTP shim — when api.datadive.tools returns an error,\n * we want the LLM (and ultimately the user) to see a useful, actionable message\n * rather than \"Request failed\". `ApiError.fromHttp` turns an HTTP status + body\n * into one of those messages.\n *\n * Source of truth for status semantics:\n *   datadive-backend/src/external-api/auth/api-key.guard.ts (401/402 logic)\n *   datadive-backend/src/external-api/external-api-v1.controller.ts (per-route docs)\n */\n\nconst KEY_HELP_URL = \"https://app.datadive.tools/api-key\";\n\nexport type ApiErrorKind =\n  | \"auth\"\n  | \"payment\"\n  | \"forbidden\"\n  | \"not_found\"\n  | \"bad_request\"\n  | \"rate_limit\"\n  | \"server\"\n  | \"network\"\n  | \"http\";\n\nexport class ApiError extends Error {\n  public readonly kind: ApiErrorKind;\n  public readonly status: number;\n  public readonly body: unknown;\n\n  constructor(kind: ApiErrorKind, status: number, message: string, body?: unknown) {\n    super(message);\n    this.name = \"ApiError\";\n    this.kind = kind;\n    this.status = status;\n    this.body = body;\n  }\n\n  static fromHttp(status: number, body: unknown): ApiError {\n    const serverMsg = extractMessage(body);\n\n    if (status === 400) {\n      return new ApiError(\n        \"bad_request\",\n        400,\n        serverMsg ? `Bad request: ${serverMsg}` : \"Bad request: invalid parameters.\",\n        body,\n      );\n    }\n    if (status === 401) {\n      return new ApiError(\n        \"auth\",\n        401,\n        `Authentication failed: your DATADIVE_API_KEY is invalid or expired. Generate a new key at ${KEY_HELP_URL}.`,\n        body,\n      );\n    }\n    if (status === 402) {\n      return new ApiError(\n        \"payment\",\n        402,\n        \"Subscription is inactive or paused. Resume billing at https://app.datadive.tools to use the API.\",\n        body,\n      );\n    }\n    if (status === 403) {\n      return new ApiError(\n        \"forbidden\",\n        403,\n        serverMsg\n          ? `Forbidden: ${serverMsg}`\n          : \"Forbidden: this API key cannot access the requested resource.\",\n        body,\n      );\n    }\n    if (status === 404) {\n      return new ApiError(\"not_found\", 404, serverMsg ? `Not found: ${serverMsg}` : \"Resource not found.\", body);\n    }\n    if (status === 429) {\n      return new ApiError(\"rate_limit\", 429, \"Rate limit exceeded. Wait a few seconds and retry.\", body);\n    }\n    if (status >= 500) {\n      return new ApiError(\n        \"server\",\n        status,\n        `DataDive API error (${status}). ${serverMsg ?? \"Please try again.\"}`.trim(),\n        body,\n      );\n    }\n    return new ApiError(\"http\", status, serverMsg ?? `HTTP ${status}`, body);\n  }\n}\n\nfunction extractMessage(body: unknown): string | null {\n  if (!body || typeof body !== \"object\") return null;\n  const b = body as Record<string, unknown>;\n  // NestJS conventional error shapes: { message: string | string[] } or { error, message }.\n  if (typeof b.message === \"string\") return b.message;\n  if (Array.isArray(b.message) && b.message.every((m) => typeof m === \"string\")) {\n    return (b.message as string[]).join(\"; \");\n  }\n  if (typeof b.error === \"string\") return b.error;\n  return null;\n}\n","/**\n * HTTP client for the DataDive /v1 API.\n *\n * Responsibilities:\n *   1. Attach `x-api-key` from config to every request.\n *   2. Tag the User-Agent with the package version + tool name so backend access\n *      logs can attribute usage per tool (no separate telemetry endpoint needed).\n *   3. Map HTTP errors via `ApiError.fromHttp`.\n *   4. Unwrap the `ResponseDto<T>` envelope (`{ message?, success?, data }`)\n *      while preserving bare `PaginationResponse<T>` bodies (which need their\n *      pagination metadata to reach the LLM).\n *\n * Envelope detection (verified against datadive-backend):\n *   - GET /v1/niches            -> NicheList extends PaginationResponse<NicheItem>  (BARE)\n *   - GET /v1/niches/rank-radars -> ResponseDto<ExternalRankRadarListResponseDto>\n *                                   where the inner DTO IS itself paginated.\n *   - All other read endpoints  -> ResponseDto<T>                                  (UNWRAP)\n *\n * Heuristic: if the body has `data` AND any pagination key (currentPage, lastPage,\n * hasNext, hasPrev, pageSize, total), it's a PaginationResponse — return as-is.\n * Otherwise if the body has `data`, it's a ResponseDto envelope — return body.data.\n *\n * Cite: datadive-backend/src/common/pagination/pagination.dto.ts (pagination keys)\n *       datadive-backend/src/common/dto/response.dto.ts          (envelope shape)\n */\n\nimport type { Config } from \"../config.js\";\nimport { ApiError } from \"./errors.js\";\n\n/** Bumped at release time; written into the User-Agent header. */\nexport const PKG_VERSION = \"0.1.0\";\n\nconst PAGINATION_KEYS = [\"currentPage\", \"lastPage\", \"hasNext\", \"hasPrev\", \"pageSize\", \"total\"] as const;\n\nexport interface RequestContext {\n  config: Config;\n  /** Tool name used to tag the User-Agent header for per-tool log attribution. */\n  toolName: string;\n}\n\nexport async function httpGet<T>(ctx: RequestContext, path: string, query?: Record<string, unknown>): Promise<T> {\n  const url = buildUrl(ctx.config.baseUrl, path, query);\n\n  let res: Response;\n  try {\n    res = await fetch(url, {\n      method: \"GET\",\n      headers: {\n        \"x-api-key\": ctx.config.apiKey,\n        accept: \"application/json\",\n        \"user-agent\": userAgent(ctx.toolName),\n      },\n    });\n  } catch (e) {\n    const msg = e instanceof Error ? e.message : String(e);\n    throw new ApiError(\"network\", 0, `Network error reaching ${url}: ${msg}`);\n  }\n\n  const text = await res.text();\n  let body: unknown;\n  try {\n    body = text.length > 0 ? JSON.parse(text) : null;\n  } catch {\n    body = text;\n  }\n\n  if (!res.ok) {\n    throw ApiError.fromHttp(res.status, body);\n  }\n\n  return unwrap<T>(body);\n}\n\nfunction buildUrl(baseUrl: string, path: string, query?: Record<string, unknown>): string {\n  const normalizedPath = path.startsWith(\"/\") ? path : `/${path}`;\n  const u = new URL(`${baseUrl}${normalizedPath}`);\n  if (query) {\n    for (const [k, v] of Object.entries(query)) {\n      if (v === undefined || v === null) continue;\n      u.searchParams.set(k, String(v));\n    }\n  }\n  return u.toString();\n}\n\nfunction userAgent(toolName: string): string {\n  return `datadive-mcp/${PKG_VERSION} tool/${toolName}`;\n}\n\n/**\n * Unwraps a ResponseDto<T> envelope while preserving bare PaginationResponse bodies.\n * Exported for unit testing.\n */\nexport function unwrap<T>(body: unknown): T {\n  if (!isObject(body)) return body as T;\n  if (!(\"data\" in body)) return body as T;\n  // If pagination metadata is present at the top level, return as-is.\n  for (const key of PAGINATION_KEYS) {\n    if (key in body) return body as T;\n  }\n  // Plain ResponseDto envelope -> unwrap.\n  return (body as { data: T }).data;\n}\n\nfunction isObject(v: unknown): v is Record<string, unknown> {\n  return typeof v === \"object\" && v !== null && !Array.isArray(v);\n}\n","import { z } from \"zod\";\nimport { httpGet } from \"../http/client.js\";\nimport type { GetMasterKeywordListResult } from \"../types/api.js\";\nimport type { ToolDefinition } from \"./types.js\";\n\nconst inputSchema = {\n  nicheId: z.string().min(1).describe(\"The unique identifier of the Niche (from `list_niches`).\"),\n};\n\nexport const getNicheKeywordsTool: ToolDefinition<typeof inputSchema> = {\n  name: \"get_niche_keywords\",\n  title: \"Get Master Keyword List for a Niche\",\n  description:\n    \"Use this when the user asks about keywords, search terms, or search volume for a niche. \" +\n    \"Retrieves the master keyword list for the specified Niche — the relevant search terms \" +\n    \"monitored for ranking and performance metrics. For each keyword, returns search volume, \" +\n    \"relevancy (numeric score or \\\"Outlier\\\"), and competitor ASIN organic ranks \" +\n    \"(asinRanks: { ASIN -> rank | null }). Also returns the latestResearchDate.\",\n  inputSchema,\n  handler: async (args, ctx) => {\n    return await httpGet<GetMasterKeywordListResult>(\n      { config: ctx.config, toolName: \"get_niche_keywords\" },\n      `/v1/niches/${encodeURIComponent(args.nicheId)}/keywords`,\n    );\n  },\n};\n","import { z } from \"zod\";\nimport { httpGet } from \"../http/client.js\";\nimport type { GetCompetitorListResult } from \"../types/api.js\";\nimport type { ToolDefinition } from \"./types.js\";\n\nconst inputSchema = {\n  nicheId: z.string().min(1).describe(\"The unique identifier of the Niche (from `list_niches`).\"),\n};\n\nexport const getNicheCompetitorsTool: ToolDefinition<typeof inputSchema> = {\n  name: \"get_niche_competitors\",\n  title: \"Get Competitors and Niche Statistics\",\n  description:\n    \"Use this for competitor ASINs, sales/revenue benchmarks, or niche opportunity scoring. \" +\n    \"Retrieves the list of Competitors within the specified Niche along with Niche statistics. \" +\n    \"For the Niche: keyword statistics, opportunity evaluation, benchmark median values, and \" +\n    \"overall competitor strength assessment. For each Competitor: ASIN, sales, revenue, ratings, \" +\n    \"reviews, price, image URL, and ranking data.\",\n  inputSchema,\n  handler: async (args, ctx) => {\n    return await httpGet<GetCompetitorListResult>(\n      { config: ctx.config, toolName: \"get_niche_competitors\" },\n      `/v1/niches/${encodeURIComponent(args.nicheId)}/competitors`,\n    );\n  },\n};\n","import { z } from \"zod\";\nimport { httpGet } from \"../http/client.js\";\nimport type { NicheRankingJuices } from \"../types/api.js\";\nimport type { ToolDefinition } from \"./types.js\";\n\nconst inputSchema = {\n  nicheId: z.string().min(1).describe(\"The unique identifier of the Niche (from `list_niches`).\"),\n};\n\nexport const getRankingJuiceTool: ToolDefinition<typeof inputSchema> = {\n  name: \"get_ranking_juice\",\n  title: \"Get Ranking Juices for a Niche\",\n  description:\n    \"Use this when the user asks 'how do I rank higher', 'what's my ranking juice', or wants \" +\n    \"listing-optimization guidance. \" +\n    \"Retrieves the Ranking Juices for each Competitor within the specified Niche. Ranking Juice is \" +\n    \"DataDive's proprietary metric identifying the key factors driving search-ranking success \" +\n    \"for each Competitor's listing. Returns currentListing and optimizedListing breakdowns \" +\n    \"(rankingJuice + per-property contributions: title, bullets, description) plus per-competitor \" +\n    \"listing scores and the latestResearchDate.\",\n  inputSchema,\n  handler: async (args, ctx) => {\n    return await httpGet<NicheRankingJuices>(\n      { config: ctx.config, toolName: \"get_ranking_juice\" },\n      `/v1/niches/${encodeURIComponent(args.nicheId)}/ranking-juices`,\n    );\n  },\n};\n","import { z } from \"zod\";\nimport { httpGet } from \"../http/client.js\";\nimport { RANK_RADAR_STATUSES, type RankRadarList } from \"../types/api.js\";\nimport type { ToolDefinition } from \"./types.js\";\n\nconst inputSchema = {\n  currentPage: z.number().int().min(1).optional().describe(\"Page number, 1-indexed. Defaults to 1.\"),\n  pageSize: z\n    .number()\n    .int()\n    .min(1)\n    .max(100)\n    .optional()\n    .describe(\"Items per page (max 100). Defaults to 20.\"),\n  nicheId: z\n    .string()\n    .min(1)\n    .optional()\n    .describe(\"Filter Rank Radars by Niche identifier. Use after `list_niches`.\"),\n  status: z\n    .enum(RANK_RADAR_STATUSES)\n    .optional()\n    .describe(\n      \"Filter by Rank Radar status. By default, returns only ACTIVE Rank Radars. Allowed: ACTIVE, PAUSED, ARCHIVED.\",\n    ),\n  searchText: z.string().optional().describe(\"Filter Rank Radars by ASIN or product title.\"),\n};\n\nexport const listRankRadarsTool: ToolDefinition<typeof inputSchema> = {\n  name: \"list_rank_radars\",\n  title: \"List Rank Radars\",\n  description:\n    \"Use this to find a `rankRadarId` before calling `get_rank_radar_data`. Filter by `nicheId` \" +\n    \"if the user has already identified a niche. \" +\n    \"Retrieves a paginated list of Rank Radars — keyword-rank trackers monitoring organic and \" +\n    \"sponsored positions for specific ASINs over time. Each item includes id, asin (with id, krtId, \" +\n    \"asin), marketplace, keywordCount, title, imageUrl, and summary metrics: top10KW, top10SV, \" +\n    \"top50KW, top50SV. Supports pagination metadata (currentPage, pageSize, total, lastPage, \" +\n    \"hasNext, hasPrev).\",\n  inputSchema,\n  handler: async (args, ctx) => {\n    return await httpGet<RankRadarList>(\n      { config: ctx.config, toolName: \"list_rank_radars\" },\n      \"/v1/niches/rank-radars\",\n      {\n        currentPage: args.currentPage,\n        pageSize: args.pageSize,\n        nicheId: args.nicheId,\n        status: args.status,\n        searchText: args.searchText,\n      },\n    );\n  },\n};\n","/**\n * Hand-mirrored DTOs from the DataDive backend (v1 external API).\n *\n * Source of truth (in this priority order):\n *   1. Live Swagger:    https://developer.datadive.tools/docs#/v1\n *                       (machine-readable: https://developer.datadive.tools/docs-json)\n *   2. Backend DTOs:    datadive-backend/src/external-api/dto/*.ts\n *                       datadive-backend/src/niche-research/dto/rank-radar.response.dto.ts\n *                       datadive-backend/src/common/dto/response.dto.ts\n *                       datadive-backend/src/common/pagination/pagination.dto.ts\n *   3. Controller:      datadive-backend/src/external-api/external-api-v1.controller.ts\n *\n * Last synced: 2026-05-05.\n *\n * The MCP server forwards JSON straight to the LLM, so deeply-nested DTOs are\n * intentionally typed loosely (with `unknown` or pass-through Records) where\n * the TS surface doesn't add safety. Pin tighter as use cases require.\n */\n\n// ─── Envelope + pagination ───────────────────────────────────────────────────\n\n/** Generic NestJS response envelope: { message?, success?, data? }. */\nexport interface ResponseEnvelope<T> {\n  message?: string;\n  /** @deprecated — use HTTP status as the success indicator. */\n  success?: boolean;\n  data?: T | null;\n}\n\n/** Standard pagination envelope returned by list endpoints. */\nexport interface PaginationResponse<T> {\n  data: T[];\n  currentPage: number;\n  pageSize: number;\n  total: number;\n  lastPage: number;\n  hasNext: boolean;\n  hasPrev: boolean;\n}\n\n// ─── /v1/niches  (NicheList = PaginationResponse<NicheItem>) ─────────────────\n\nexport interface NicheItem {\n  nicheId: string;\n  heroKeyword: string;\n  nicheLabel: string;\n  /** Amazon marketplace TLD: \"com\", \"uk\", \"de\", etc. */\n  marketplace: string;\n  /** ISO date string when the Niche was last researched. Nullable. */\n  latestResearchDate: string | null;\n}\n\nexport type NicheList = PaginationResponse<NicheItem>;\n\n// ─── /v1/niches/:nicheId/keywords  (GetMasterKeywordListResult, wrapped) ─────\n\n/** Map of competitor ASIN -> rank (or null when unranked). */\nexport type AsinRanks = Record<string, number | null>;\n\nexport interface MasterKeyword {\n  keyword: string;\n  searchVolume: number;\n  /** \"Outlier\" or a numeric relevancy score. */\n  relevancy: string | number;\n  asinRanks: AsinRanks;\n}\n\nexport interface GetMasterKeywordListResult {\n  keywords: MasterKeyword[];\n  /** ISO date string. */\n  latestResearchDate: string;\n}\n\n// ─── /v1/niches/:nicheId/competitors  (GetCompetitorListResult, wrapped) ─────\n\n/**\n * Niche competitors response — many nested DTOs from the backend (MklStatisticsData,\n * OpportunityEvaluation, MklBenchmark, CompetitorsStrength, AsinListItem). We type\n * the outer shape and leave the inner objects as opaque records; the LLM sees the\n * full JSON and can reason about it. Tighten if a specific consumer needs it.\n */\nexport interface GetCompetitorListResult {\n  /** Marketplace enum (AmazonStore in backend). */\n  marketplace: string;\n  statistics: Record<string, unknown>;\n  opportunityEvaluation: Record<string, unknown>;\n  benchmark: Record<string, unknown>;\n  competitorsStrength: Record<string, unknown>;\n  competitors: Array<Record<string, unknown>>;\n  latestResearchDate: string;\n}\n\n// ─── /v1/niches/:nicheId/ranking-juices  (NicheRankingJuices, wrapped) ───────\n\nexport interface RankingJuiceProperty {\n  rankingJuice: number;\n}\n\nexport interface ListingRankingJuice {\n  rankingJuice: number;\n  title: RankingJuiceProperty;\n  bullets: RankingJuiceProperty;\n  description: RankingJuiceProperty;\n}\n\nexport interface CompetitorRankingJuice {\n  asin: string;\n  listing: ListingRankingJuice;\n}\n\nexport interface NicheRankingJuices {\n  currentListing: ListingRankingJuice;\n  optimizedListing: ListingRankingJuice;\n  competitors: CompetitorRankingJuice[];\n  latestResearchDate: string;\n}\n\n// ─── /v1/niches/rank-radars  (ExternalRankRadarListResponseDto, wrapped) ─────\n\nexport interface RankRadarAsin {\n  id: string;\n  krtId: string;\n  asin: string;\n}\n\nexport interface RankRadarItem {\n  id: string;\n  asin: RankRadarAsin;\n  marketplace: string;\n  keywordCount: number;\n  title: string;\n  imageUrl: string;\n  top10KW: number | null;\n  top10SV: number | null;\n  top50KW: number | null;\n  top50SV: number | null;\n}\n\nexport type RankRadarList = PaginationResponse<RankRadarItem>;\n\n/** Allowed values for the `status` query param on /v1/niches/rank-radars. */\nexport const RANK_RADAR_STATUSES = [\"ACTIVE\", \"PAUSED\", \"ARCHIVED\"] as const;\nexport type RankRadarStatus = (typeof RANK_RADAR_STATUSES)[number];\n\n// ─── /v1/niches/rank-radars/:rankRadarId  (KrtKeywordResponseDto[], wrapped) ─\n\nexport interface KrtAsinRank {\n  /** ISO date string. */\n  date: string;\n  organicRank?: number | null;\n  impressionRank?: number | null;\n}\n\nexport interface KrtKeyword {\n  id: string;\n  keyword: string;\n  searchVolume: number | null;\n  ranks: KrtAsinRank[];\n  /** Highlight annotations (KrtHighlightDto in backend); kept opaque for MVP. */\n  highlights: Array<Record<string, unknown>>;\n}\n\nexport type RankRadarKeywordList = KrtKeyword[];\n","import { z } from \"zod\";\nimport { httpGet } from \"../http/client.js\";\nimport type { RankRadarKeywordList } from \"../types/api.js\";\nimport type { ToolDefinition } from \"./types.js\";\n\n/** yyyy-mm-dd matcher used by both startDate and endDate. */\nconst ISO_DATE = /^\\d{4}-\\d{2}-\\d{2}$/;\n\nconst inputSchema = {\n  rankRadarId: z\n    .string()\n    .uuid()\n    .describe(\"The Rank Radar UUID (from `list_rank_radars`).\"),\n  startDate: z\n    .string()\n    .regex(ISO_DATE, \"startDate must be in yyyy-mm-dd format\")\n    .describe(\"Start date for the ranking data range, yyyy-mm-dd (e.g. 2024-03-26).\"),\n  endDate: z\n    .string()\n    .regex(ISO_DATE, \"endDate must be in yyyy-mm-dd format\")\n    .describe(\"End date for the ranking data range, yyyy-mm-dd (e.g. 2024-04-26). Must be on or after startDate.\"),\n};\n\nexport const getRankRadarDataTool: ToolDefinition<typeof inputSchema> = {\n  name: \"get_rank_radar_data\",\n  title: \"Get Keyword Rankings for a Rank Radar\",\n  description:\n    \"Use this to analyze keyword ranking trends over time. Requires startDate and endDate (yyyy-mm-dd). \" +\n    \"Retrieves historical keyword ranking data for the specified Rank Radar within the date range. \" +\n    \"Returns an array of tracked keywords; each has id, keyword, searchVolume, ranks (per-day \" +\n    \"{ date, organicRank, impressionRank }), and any highlight annotations. Use after \" +\n    \"`list_rank_radars` to discover a `rankRadarId`.\",\n  inputSchema,\n  handler: async (args, ctx) => {\n    return await httpGet<RankRadarKeywordList>(\n      { config: ctx.config, toolName: \"get_rank_radar_data\" },\n      `/v1/niches/rank-radars/${encodeURIComponent(args.rankRadarId)}`,\n      { startDate: args.startDate, endDate: args.endDate },\n    );\n  },\n};\n","/**\n * Tool registry. The order here is the order tools appear in `tools/list`\n * over the MCP transport, which biases LLM discovery — keep \"discovery\" tools\n * (the ones that return IDs needed by other tools) at the top.\n */\n\nimport { listNichesTool } from \"./list-niches.js\";\nimport { getNicheKeywordsTool } from \"./get-niche-keywords.js\";\nimport { getNicheCompetitorsTool } from \"./get-niche-competitors.js\";\nimport { getRankingJuiceTool } from \"./get-ranking-juice.js\";\nimport { listRankRadarsTool } from \"./list-rank-radars.js\";\nimport { getRankRadarDataTool } from \"./get-rank-radar-data.js\";\nimport type { AnyTool } from \"./types.js\";\n\n// Note on the cast: each ToolDefinition<S> has a handler typed to its specific\n// schema; the registry needs a uniform shape. The MCP SDK validates incoming\n// args against `inputSchema` before calling the handler, so the cast is safe.\nexport const allTools: ReadonlyArray<AnyTool> = [\n  listNichesTool,\n  getNicheKeywordsTool,\n  getNicheCompetitorsTool,\n  getRankingJuiceTool,\n  listRankRadarsTool,\n  getRankRadarDataTool,\n] as unknown as ReadonlyArray<AnyTool>;\n\nexport type { ToolDefinition, AnyTool } from \"./types.js\";\n"],"mappings":"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","names":["KEY_HELP_URL","z","inputSchema","z","z","inputSchema","z","z","inputSchema","z","z","inputSchema","z","z","inputSchema","z"]}
+{"version":3,"sources":["../src/index.ts","../src/config.ts","../src/server.ts","../src/tools/list-niches.ts","../src/http/errors.ts","../package.json","../src/http/client.ts","../src/tools/get-niche-keywords.ts","../src/tools/get-niche-competitors.ts","../src/tools/get-ranking-juice.ts","../src/tools/list-rank-radars.ts","../src/types/api.ts","../src/tools/get-rank-radar-data.ts","../src/tools/get-asin-inventory-distribution.ts","../src/tools/index.ts"],"sourcesContent":["/**\n * Entry point for the datadive-mcp stdio binary.\n *\n * Wired via package.json#bin -> dist/index.js so `npx -y @datadive-tools/mcp` runs it.\n * The shebang is added at build time by tsup.config.ts (banner.js).\n */\n\nimport { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\";\nimport { loadConfig } from \"./config.js\";\nimport { buildServer } from \"./server.js\";\n\nasync function main() {\n  let config;\n  try {\n    config = loadConfig();\n  } catch (err) {\n    // Config errors (e.g. missing API key) are user-facing; print to stderr and exit\n    // non-zero so the MCP client surfaces a real error rather than silently disconnecting.\n    const msg = err instanceof Error ? err.message : String(err);\n    process.stderr.write(`[datadive-mcp] ${msg}\\n`);\n    process.exit(1);\n  }\n\n  const server = buildServer(config);\n  const transport = new StdioServerTransport();\n  await server.connect(transport);\n}\n\nmain().catch((err) => {\n  const msg = err instanceof Error ? (err.stack ?? err.message) : String(err);\n  process.stderr.write(`[datadive-mcp] fatal: ${msg}\\n`);\n  process.exit(1);\n});\n","/**\n * Loads and validates the server's runtime configuration from environment.\n *\n * Required:\n *   DATADIVE_API_KEY        - your DataDive API key (generate at 2.datadive.tools/api-key)\n *\n * Optional:\n *   DATADIVE_API_BASE_URL   - override the API base URL (defaults to https://api.datadive.tools)\n */\n\nexport interface Config {\n  apiKey: string;\n  baseUrl: string;\n}\n\nconst DEFAULT_BASE_URL = \"https://api.datadive.tools\";\nconst KEY_HELP_URL = \"https://2.datadive.tools/api-key\";\n\nexport function loadConfig(env: NodeJS.ProcessEnv = process.env): Config {\n  const apiKey = (env.DATADIVE_API_KEY ?? \"\").trim();\n  if (!apiKey) {\n    throw new Error(\n      `DATADIVE_API_KEY environment variable is required. Generate one at ${KEY_HELP_URL} ` +\n        `and add it to your MCP client config under env.DATADIVE_API_KEY.`,\n    );\n  }\n\n  const rawBase = (env.DATADIVE_API_BASE_URL ?? DEFAULT_BASE_URL).trim();\n  // Normalize: strip trailing slashes so we can append \"/v1/...\" paths cleanly.\n  const baseUrl = rawBase.replace(/\\/+$/, \"\");\n\n  return { apiKey, baseUrl };\n}\n","/**\n * Builds the MCP server: registers each tool from the registry with the SDK.\n *\n * Error handling: if a tool handler throws (most commonly an ApiError from the\n * HTTP client), we surface the message back through MCP as a tool-level error\n * (`isError: true`). The LLM sees the message and can react — e.g. tell the\n * user to regenerate their API key on a 401.\n */\n\nimport { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport type { Config } from \"./config.js\";\nimport { allTools } from \"./tools/index.js\";\nimport { ApiError } from \"./http/errors.js\";\nimport { PKG_VERSION, takeUpgradeNotice } from \"./http/client.js\";\n\nexport function buildServer(config: Config): McpServer {\n  const server = new McpServer({\n    name: \"datadive\",\n    version: PKG_VERSION,\n  });\n\n  for (const tool of allTools) {\n    server.registerTool(\n      tool.name,\n      {\n        title: tool.title,\n        description: tool.description,\n        inputSchema: tool.inputSchema,\n      },\n      async (args: Record<string, unknown>) => {\n        try {\n          const data = await tool.handler(args, { config });\n          const content = [\n            {\n              type: \"text\" as const,\n              text: JSON.stringify(data, null, 2),\n            },\n          ];\n          // If the backend signaled a newer release, append a one-time upgrade\n          // nudge so the model relays it to the user. takeUpgradeNotice() returns\n          // null after the first time, so this fires at most once per session.\n          const notice = takeUpgradeNotice();\n          if (notice) {\n            content.push({\n              type: \"text\" as const,\n              text: `⚠️ datadive-mcp update available — ${notice}`,\n            });\n          }\n          return { content };\n        } catch (err) {\n          return {\n            isError: true,\n            content: [\n              {\n                type: \"text\" as const,\n                text: err instanceof ApiError ? err.message : err instanceof Error ? err.message : String(err),\n              },\n            ],\n          };\n        }\n      },\n    );\n  }\n\n  return server;\n}\n","import { z } from \"zod\";\nimport { httpGet } from \"../http/client.js\";\nimport type { NicheList } from \"../types/api.js\";\nimport type { ToolDefinition } from \"./types.js\";\n\nconst inputSchema = {\n  currentPage: z\n    .number()\n    .int()\n    .min(1)\n    .optional()\n    .describe(\"Page number, 1-indexed. Defaults to 1.\"),\n  pageSize: z\n    .number()\n    .int()\n    .min(1)\n    .max(100)\n    .optional()\n    .describe(\"Items per page (max 100). Defaults to 20.\"),\n};\n\nexport const listNichesTool: ToolDefinition<typeof inputSchema> = {\n  name: \"list_niches\",\n  title: \"List DataDive Niches\",\n  description:\n    \"Use this first when the user asks about their niches, or to find a `nicheId` for use with \" +\n    \"`get_niche_keywords`, `get_niche_competitors`, or `get_ranking_juice`. \" +\n    \"Retrieves a paginated list of Niches. Each Niche represents a market segment or product \" +\n    \"category being tracked. Returns nicheId, heroKeyword, nicheLabel, marketplace (com/uk/de/...), \" +\n    \"and latestResearchDate per niche, plus pagination metadata (currentPage, pageSize, total, \" +\n    \"lastPage, hasNext, hasPrev).\",\n  inputSchema,\n  handler: async (args, ctx) => {\n    return await httpGet<NicheList>(\n      { config: ctx.config, toolName: \"list_niches\" },\n      \"/v1/niches\",\n      { currentPage: args.currentPage, pageSize: args.pageSize },\n    );\n  },\n};\n","/**\n * Error mapping for the DataDive /v1 API.\n *\n * The MCP server is a thin HTTP shim — when api.datadive.tools returns an error,\n * we want the LLM (and ultimately the user) to see a useful, actionable message\n * rather than \"Request failed\". `ApiError.fromHttp` turns an HTTP status + body\n * into one of those messages.\n *\n * Source of truth for status semantics:\n *   datadive-backend/src/external-api/auth/api-key.guard.ts (401/402 logic)\n *   datadive-backend/src/external-api/external-api-v1.controller.ts (per-route docs)\n */\n\nconst KEY_HELP_URL = \"https://2.datadive.tools/api-key\";\n\nexport type ApiErrorKind =\n  | \"auth\"\n  | \"payment\"\n  | \"forbidden\"\n  | \"not_found\"\n  | \"bad_request\"\n  | \"rate_limit\"\n  | \"server\"\n  | \"network\"\n  | \"http\";\n\nexport class ApiError extends Error {\n  public readonly kind: ApiErrorKind;\n  public readonly status: number;\n  public readonly body: unknown;\n\n  constructor(kind: ApiErrorKind, status: number, message: string, body?: unknown) {\n    super(message);\n    this.name = \"ApiError\";\n    this.kind = kind;\n    this.status = status;\n    this.body = body;\n  }\n\n  static fromHttp(status: number, body: unknown): ApiError {\n    const serverMsg = extractMessage(body);\n\n    if (status === 400) {\n      return new ApiError(\n        \"bad_request\",\n        400,\n        serverMsg ? `Bad request: ${serverMsg}` : \"Bad request: invalid parameters.\",\n        body,\n      );\n    }\n    if (status === 401) {\n      return new ApiError(\n        \"auth\",\n        401,\n        `Authentication failed: your DATADIVE_API_KEY is invalid or expired. Generate a new key at ${KEY_HELP_URL}.`,\n        body,\n      );\n    }\n    if (status === 402) {\n      return new ApiError(\n        \"payment\",\n        402,\n        \"Subscription is inactive or paused. Resume billing at https://2.datadive.tools to use the API.\",\n        body,\n      );\n    }\n    if (status === 403) {\n      return new ApiError(\n        \"forbidden\",\n        403,\n        serverMsg\n          ? `Forbidden: ${serverMsg}`\n          : \"Forbidden: this API key cannot access the requested resource.\",\n        body,\n      );\n    }\n    if (status === 404) {\n      return new ApiError(\"not_found\", 404, serverMsg ? `Not found: ${serverMsg}` : \"Resource not found.\", body);\n    }\n    if (status === 429) {\n      return new ApiError(\"rate_limit\", 429, \"Rate limit exceeded. Wait a few seconds and retry.\", body);\n    }\n    if (status >= 500) {\n      return new ApiError(\n        \"server\",\n        status,\n        `DataDive API error (${status}). ${serverMsg ?? \"Please try again.\"}`.trim(),\n        body,\n      );\n    }\n    return new ApiError(\"http\", status, serverMsg ?? `HTTP ${status}`, body);\n  }\n}\n\nfunction extractMessage(body: unknown): string | null {\n  if (!body || typeof body !== \"object\") return null;\n  const b = body as Record<string, unknown>;\n  // NestJS conventional error shapes: { message: string | string[] } or { error, message }.\n  if (typeof b.message === \"string\") return b.message;\n  if (Array.isArray(b.message) && b.message.every((m) => typeof m === \"string\")) {\n    return (b.message as string[]).join(\"; \");\n  }\n  if (typeof b.error === \"string\") return b.error;\n  return null;\n}\n","{\n  \"name\": \"@datadive-tools/mcp\",\n  \"version\": \"0.3.0\",\n  \"description\": \"MCP server for DataDive — query your niches, keywords, competitors, and Rank Radar data from Claude Desktop, Claude Code, or Cursor.\",\n  \"type\": \"module\",\n  \"bin\": {\n    \"datadive-mcp\": \"./dist/index.js\"\n  },\n  \"main\": \"./dist/index.js\",\n  \"files\": [\n    \"dist\",\n    \"README.md\",\n    \"LICENSE\"\n  ],\n  \"engines\": {\n    \"node\": \">=22\"\n  },\n  \"scripts\": {\n    \"build\": \"tsup\",\n    \"dev\": \"tsup --watch\",\n    \"test\": \"vitest run\",\n    \"test:watch\": \"vitest\",\n    \"test:smoke\": \"DATADIVE_SMOKE=1 vitest run test/smoke.test.ts\",\n    \"lint\": \"eslint .\",\n    \"typecheck\": \"tsc --noEmit\",\n    \"prepublishOnly\": \"npm run lint && npm run typecheck && npm run test && npm run build\"\n  },\n  \"keywords\": [\n    \"mcp\",\n    \"model-context-protocol\",\n    \"datadive\",\n    \"amazon\",\n    \"claude\"\n  ],\n  \"author\": \"DataDive\",\n  \"license\": \"MIT\",\n  \"homepage\": \"https://github.com/Data-Dive-Tools/datadive-mcp\",\n  \"repository\": {\n    \"type\": \"git\",\n    \"url\": \"https://github.com/Data-Dive-Tools/datadive-mcp.git\"\n  },\n  \"bugs\": {\n    \"url\": \"https://github.com/Data-Dive-Tools/datadive-mcp/issues\"\n  },\n  \"dependencies\": {\n    \"@modelcontextprotocol/sdk\": \"^1.0.0\",\n    \"zod\": \"^3.23.0\"\n  },\n  \"devDependencies\": {\n    \"@changesets/cli\": \"^2.27.0\",\n    \"@types/node\": \"^20.0.0\",\n    \"@typescript-eslint/eslint-plugin\": \"^8.0.0\",\n    \"@typescript-eslint/parser\": \"^8.0.0\",\n    \"eslint\": \"^9.0.0\",\n    \"prettier\": \"^3.0.0\",\n    \"tsup\": \"^8.0.0\",\n    \"typescript\": \"~5.9.0\",\n    \"vitest\": \"^2.0.0\"\n  }\n}\n","/**\n * HTTP client for the DataDive /v1 API.\n *\n * Responsibilities:\n *   1. Attach `x-api-key` from config to every request.\n *   2. Tag the User-Agent with the package version + tool name so backend access\n *      logs can attribute usage per tool (no separate telemetry endpoint needed).\n *   3. Map HTTP errors via `ApiError.fromHttp`.\n *   4. Unwrap the `ResponseDto<T>` envelope (`{ message?, success?, data }`)\n *      while preserving bare `PaginationResponse<T>` bodies (which need their\n *      pagination metadata to reach the LLM).\n *\n * Envelope detection (verified against datadive-backend):\n *   - GET /v1/niches            -> NicheList extends PaginationResponse<NicheItem>  (BARE)\n *   - GET /v1/niches/rank-radars -> ResponseDto<ExternalRankRadarListResponseDto>\n *                                   where the inner DTO IS itself paginated.\n *   - All other read endpoints  -> ResponseDto<T>                                  (UNWRAP)\n *\n * Heuristic: if the body has `data` AND any pagination key (currentPage, lastPage,\n * hasNext, hasPrev, pageSize, total), it's a PaginationResponse — return as-is.\n * Otherwise if the body has `data`, it's a ResponseDto envelope — return body.data.\n *\n * Cite: datadive-backend/src/common/pagination/pagination.dto.ts (pagination keys)\n *       datadive-backend/src/common/dto/response.dto.ts          (envelope shape)\n */\n\nimport type { Config } from \"../config.js\";\nimport { ApiError } from \"./errors.js\";\nimport { version } from \"../../package.json\";\n\n/**\n * The running package version, inlined from package.json at build time by\n * tsup/esbuild (and by vite under vitest). Single source of truth — no manual\n * bump here, so it can never drift from what's published to npm.\n *\n * Written into the User-Agent header, and compared against the backend's\n * advertised latest version (see noteLatestVersion) to nudge stale installs.\n */\nexport const PKG_VERSION: string = version;\n\n/** Response header the DataDive backend uses to advertise the latest published MCP version. */\nconst LATEST_VERSION_HEADER = \"x-datadive-mcp-latest\";\n\n/**\n * One-time upgrade notice. Armed when the backend advertises a version newer than\n * the one we're running; consumed (and then suppressed for the rest of the session)\n * by takeUpgradeNotice(). We surface it once per process so we don't nag on every call.\n */\nlet pendingUpgradeNotice: string | null = null;\nlet hasWarned = false;\n\n/**\n * Compares dotted version strings (major.minor.patch). Pre-release / build suffixes\n * are stripped — a stable release is the signal we act on. Returns true iff `latest`\n * is strictly newer than `current`. Exported for unit testing.\n */\nexport function isNewerVersion(latest: string, current: string): boolean {\n  const parse = (v: string) => v.split(/[-+]/)[0]!.split(\".\").map((n) => parseInt(n, 10) || 0);\n  const a = parse(latest);\n  const b = parse(current);\n  for (let i = 0; i < 3; i++) {\n    const da = a[i] ?? 0;\n    const db = b[i] ?? 0;\n    if (da !== db) return da > db;\n  }\n  return false;\n}\n\n/** Records the advertised latest version; arms a one-time notice if we're behind. Never throws. */\nfunction noteLatestVersion(latest: string | null): void {\n  if (!latest || hasWarned) return;\n  if (isNewerVersion(latest, PKG_VERSION)) {\n    pendingUpgradeNotice =\n      `A newer version of datadive-mcp is available (${latest}; you are running ${PKG_VERSION}). ` +\n      `Update by reinstalling the latest from npm — e.g. \\`npm install -g @datadive-tools/mcp@latest\\` — ` +\n      `or bump the @datadive-tools/mcp version in your MCP client config, then restart the client.`;\n  }\n}\n\n/**\n * Returns a pending upgrade notice once, then suppresses further notices for the rest\n * of the session. Called when assembling a tool result so the LLM can relay it to the\n * user. Returns null when there's nothing to surface.\n */\nexport function takeUpgradeNotice(): string | null {\n  if (!pendingUpgradeNotice) return null;\n  const notice = pendingUpgradeNotice;\n  pendingUpgradeNotice = null;\n  hasWarned = true;\n  return notice;\n}\n\nconst PAGINATION_KEYS = [\"currentPage\", \"lastPage\", \"hasNext\", \"hasPrev\", \"pageSize\", \"total\"] as const;\n\nexport interface RequestContext {\n  config: Config;\n  /** Tool name used to tag the User-Agent header for per-tool log attribution. */\n  toolName: string;\n}\n\nexport async function httpGet<T>(ctx: RequestContext, path: string, query?: Record<string, unknown>): Promise<T> {\n  const url = buildUrl(ctx.config.baseUrl, path, query);\n\n  let res: Response;\n  try {\n    res = await fetch(url, {\n      method: \"GET\",\n      headers: {\n        \"x-api-key\": ctx.config.apiKey,\n        accept: \"application/json\",\n        \"user-agent\": userAgent(ctx.toolName),\n      },\n    });\n  } catch (e) {\n    const msg = e instanceof Error ? e.message : String(e);\n    throw new ApiError(\"network\", 0, `Network error reaching ${url}: ${msg}`);\n  }\n\n  // The backend advertises the latest published MCP version on every response\n  // (including errors); arm a one-time upgrade notice if we're behind.\n  noteLatestVersion(res.headers.get(LATEST_VERSION_HEADER));\n\n  const text = await res.text();\n  let body: unknown;\n  try {\n    body = text.length > 0 ? JSON.parse(text) : null;\n  } catch {\n    body = text;\n  }\n\n  if (!res.ok) {\n    throw ApiError.fromHttp(res.status, body);\n  }\n\n  return unwrap<T>(body);\n}\n\nfunction buildUrl(baseUrl: string, path: string, query?: Record<string, unknown>): string {\n  const normalizedPath = path.startsWith(\"/\") ? path : `/${path}`;\n  const u = new URL(`${baseUrl}${normalizedPath}`);\n  if (query) {\n    for (const [k, v] of Object.entries(query)) {\n      if (v === undefined || v === null) continue;\n      u.searchParams.set(k, String(v));\n    }\n  }\n  return u.toString();\n}\n\nfunction userAgent(toolName: string): string {\n  return `datadive-mcp/${PKG_VERSION} tool/${toolName}`;\n}\n\n/**\n * Unwraps a ResponseDto<T> envelope while preserving bare PaginationResponse bodies.\n * Exported for unit testing.\n */\nexport function unwrap<T>(body: unknown): T {\n  if (!isObject(body)) return body as T;\n  if (!(\"data\" in body)) return body as T;\n  // If pagination metadata is present at the top level, return as-is.\n  for (const key of PAGINATION_KEYS) {\n    if (key in body) return body as T;\n  }\n  // Plain ResponseDto envelope -> unwrap.\n  return (body as { data: T }).data;\n}\n\nfunction isObject(v: unknown): v is Record<string, unknown> {\n  return typeof v === \"object\" && v !== null && !Array.isArray(v);\n}\n","import { z } from \"zod\";\nimport { httpGet } from \"../http/client.js\";\nimport type { GetMasterKeywordListResult } from \"../types/api.js\";\nimport type { ToolDefinition } from \"./types.js\";\n\nconst inputSchema = {\n  nicheId: z.string().min(1).describe(\"The unique identifier of the Niche (from `list_niches`).\"),\n};\n\nexport const getNicheKeywordsTool: ToolDefinition<typeof inputSchema> = {\n  name: \"get_niche_keywords\",\n  title: \"Get Master Keyword List for a Niche\",\n  description:\n    \"Use this when the user asks about keywords, search terms, or search volume for a niche. \" +\n    \"Retrieves the master keyword list for the specified Niche — the relevant search terms \" +\n    \"monitored for ranking and performance metrics. For each keyword, returns search volume, \" +\n    \"relevancy (numeric score or \\\"Outlier\\\"), and competitor ASIN organic ranks \" +\n    \"(asinRanks: { ASIN -> rank | null }). Also returns the latestResearchDate.\",\n  inputSchema,\n  handler: async (args, ctx) => {\n    return await httpGet<GetMasterKeywordListResult>(\n      { config: ctx.config, toolName: \"get_niche_keywords\" },\n      `/v1/niches/${encodeURIComponent(args.nicheId)}/keywords`,\n    );\n  },\n};\n","import { z } from \"zod\";\nimport { httpGet } from \"../http/client.js\";\nimport type { GetCompetitorListResult } from \"../types/api.js\";\nimport type { ToolDefinition } from \"./types.js\";\n\nconst inputSchema = {\n  nicheId: z.string().min(1).describe(\"The unique identifier of the Niche (from `list_niches`).\"),\n};\n\nexport const getNicheCompetitorsTool: ToolDefinition<typeof inputSchema> = {\n  name: \"get_niche_competitors\",\n  title: \"Get Competitors and Niche Statistics\",\n  description:\n    \"Use this for competitor ASINs, sales/revenue benchmarks, or niche opportunity scoring. \" +\n    \"Retrieves the list of Competitors within the specified Niche along with Niche statistics. \" +\n    \"For the Niche: keyword statistics, opportunity evaluation, benchmark median values, and \" +\n    \"overall competitor strength assessment. For each Competitor: ASIN, sales, revenue, ratings, \" +\n    \"reviews, price, image URL, and ranking data.\",\n  inputSchema,\n  handler: async (args, ctx) => {\n    return await httpGet<GetCompetitorListResult>(\n      { config: ctx.config, toolName: \"get_niche_competitors\" },\n      `/v1/niches/${encodeURIComponent(args.nicheId)}/competitors`,\n    );\n  },\n};\n","import { z } from \"zod\";\nimport { httpGet } from \"../http/client.js\";\nimport type { NicheRankingJuices } from \"../types/api.js\";\nimport type { ToolDefinition } from \"./types.js\";\n\nconst inputSchema = {\n  nicheId: z.string().min(1).describe(\"The unique identifier of the Niche (from `list_niches`).\"),\n};\n\nexport const getRankingJuiceTool: ToolDefinition<typeof inputSchema> = {\n  name: \"get_ranking_juice\",\n  title: \"Get Ranking Juices for a Niche\",\n  description:\n    \"Use this when the user asks 'how do I rank higher', 'what's my ranking juice', or wants \" +\n    \"listing-optimization guidance. \" +\n    \"Retrieves the Ranking Juices for each Competitor within the specified Niche. Ranking Juice is \" +\n    \"DataDive's proprietary metric identifying the key factors driving search-ranking success \" +\n    \"for each Competitor's listing. Returns currentListing and optimizedListing breakdowns \" +\n    \"(rankingJuice + per-property contributions: title, bullets, description) plus per-competitor \" +\n    \"listing scores and the latestResearchDate.\",\n  inputSchema,\n  handler: async (args, ctx) => {\n    return await httpGet<NicheRankingJuices>(\n      { config: ctx.config, toolName: \"get_ranking_juice\" },\n      `/v1/niches/${encodeURIComponent(args.nicheId)}/ranking-juices`,\n    );\n  },\n};\n","import { z } from \"zod\";\nimport { httpGet } from \"../http/client.js\";\nimport { RANK_RADAR_STATUSES, type RankRadarList } from \"../types/api.js\";\nimport type { ToolDefinition } from \"./types.js\";\n\nconst inputSchema = {\n  currentPage: z.number().int().min(1).optional().describe(\"Page number, 1-indexed. Defaults to 1.\"),\n  pageSize: z\n    .number()\n    .int()\n    .min(1)\n    .max(100)\n    .optional()\n    .describe(\"Items per page (max 100). Defaults to 20.\"),\n  nicheId: z\n    .string()\n    .min(1)\n    .optional()\n    .describe(\"Filter Rank Radars by Niche identifier. Use after `list_niches`.\"),\n  status: z\n    .enum(RANK_RADAR_STATUSES)\n    .optional()\n    .describe(\n      \"Filter by Rank Radar status. By default, returns only ACTIVE Rank Radars. Allowed: ACTIVE, PAUSED, ARCHIVED.\",\n    ),\n  searchText: z.string().optional().describe(\"Filter Rank Radars by ASIN or product title.\"),\n};\n\nexport const listRankRadarsTool: ToolDefinition<typeof inputSchema> = {\n  name: \"list_rank_radars\",\n  title: \"List Rank Radars\",\n  description:\n    \"Use this to find a `rankRadarId` before calling `get_rank_radar_data`. Filter by `nicheId` \" +\n    \"if the user has already identified a niche. \" +\n    \"Retrieves a paginated list of Rank Radars — keyword-rank trackers monitoring organic and \" +\n    \"sponsored positions for specific ASINs over time. Each item includes id, asin (with id, krtId, \" +\n    \"asin), marketplace, keywordCount, title, imageUrl, and summary metrics: top10KW, top10SV, \" +\n    \"top50KW, top50SV. Supports pagination metadata (currentPage, pageSize, total, lastPage, \" +\n    \"hasNext, hasPrev).\",\n  inputSchema,\n  handler: async (args, ctx) => {\n    return await httpGet<RankRadarList>(\n      { config: ctx.config, toolName: \"list_rank_radars\" },\n      \"/v1/niches/rank-radars\",\n      {\n        currentPage: args.currentPage,\n        pageSize: args.pageSize,\n        nicheId: args.nicheId,\n        status: args.status,\n        searchText: args.searchText,\n      },\n    );\n  },\n};\n","/**\n * Hand-mirrored DTOs from the DataDive backend (v1 external API).\n *\n * Source of truth (in this priority order):\n *   1. Live Swagger:    https://developer.datadive.tools/docs#/v1\n *                       (machine-readable: https://developer.datadive.tools/docs-json)\n *   2. Backend DTOs:    datadive-backend/src/external-api/dto/*.ts\n *                       datadive-backend/src/niche-research/dto/rank-radar.response.dto.ts\n *                       datadive-backend/src/common/dto/response.dto.ts\n *                       datadive-backend/src/common/pagination/pagination.dto.ts\n *   3. Controller:      datadive-backend/src/external-api/external-api-v1.controller.ts\n *\n * Last synced: 2026-05-05.\n *\n * The MCP server forwards JSON straight to the LLM, so deeply-nested DTOs are\n * intentionally typed loosely (with `unknown` or pass-through Records) where\n * the TS surface doesn't add safety. Pin tighter as use cases require.\n */\n\n// ─── Envelope + pagination ───────────────────────────────────────────────────\n\n/** Generic NestJS response envelope: { message?, success?, data? }. */\nexport interface ResponseEnvelope<T> {\n  message?: string;\n  /** @deprecated — use HTTP status as the success indicator. */\n  success?: boolean;\n  data?: T | null;\n}\n\n/** Standard pagination envelope returned by list endpoints. */\nexport interface PaginationResponse<T> {\n  data: T[];\n  currentPage: number;\n  pageSize: number;\n  total: number;\n  lastPage: number;\n  hasNext: boolean;\n  hasPrev: boolean;\n}\n\n// ─── /v1/niches  (NicheList = PaginationResponse<NicheItem>) ─────────────────\n\nexport interface NicheItem {\n  nicheId: string;\n  heroKeyword: string;\n  nicheLabel: string;\n  /** Amazon marketplace TLD: \"com\", \"uk\", \"de\", etc. */\n  marketplace: string;\n  /** ISO date string when the Niche was last researched. Nullable. */\n  latestResearchDate: string | null;\n}\n\nexport type NicheList = PaginationResponse<NicheItem>;\n\n// ─── /v1/niches/:nicheId/keywords  (GetMasterKeywordListResult, wrapped) ─────\n\n/** Map of competitor ASIN -> rank (or null when unranked). */\nexport type AsinRanks = Record<string, number | null>;\n\nexport interface MasterKeyword {\n  keyword: string;\n  searchVolume: number;\n  /** \"Outlier\" or a numeric relevancy score. */\n  relevancy: string | number;\n  asinRanks: AsinRanks;\n}\n\nexport interface GetMasterKeywordListResult {\n  keywords: MasterKeyword[];\n  /** ISO date string. */\n  latestResearchDate: string;\n}\n\n// ─── /v1/niches/:nicheId/competitors  (GetCompetitorListResult, wrapped) ─────\n\n/**\n * Niche competitors response — many nested DTOs from the backend (MklStatisticsData,\n * OpportunityEvaluation, MklBenchmark, CompetitorsStrength, AsinListItem). We type\n * the outer shape and leave the inner objects as opaque records; the LLM sees the\n * full JSON and can reason about it. Tighten if a specific consumer needs it.\n */\nexport interface GetCompetitorListResult {\n  /** Marketplace enum (AmazonStore in backend). */\n  marketplace: string;\n  statistics: Record<string, unknown>;\n  opportunityEvaluation: Record<string, unknown>;\n  benchmark: Record<string, unknown>;\n  competitorsStrength: Record<string, unknown>;\n  competitors: Array<Record<string, unknown>>;\n  latestResearchDate: string;\n}\n\n// ─── /v1/niches/:nicheId/ranking-juices  (NicheRankingJuices, wrapped) ───────\n\nexport interface RankingJuiceProperty {\n  rankingJuice: number;\n}\n\nexport interface ListingRankingJuice {\n  rankingJuice: number;\n  title: RankingJuiceProperty;\n  bullets: RankingJuiceProperty;\n  description: RankingJuiceProperty;\n}\n\nexport interface CompetitorRankingJuice {\n  asin: string;\n  listing: ListingRankingJuice;\n}\n\nexport interface NicheRankingJuices {\n  currentListing: ListingRankingJuice;\n  optimizedListing: ListingRankingJuice;\n  competitors: CompetitorRankingJuice[];\n  latestResearchDate: string;\n}\n\n// ─── /v1/niches/rank-radars  (ExternalRankRadarListResponseDto, wrapped) ─────\n\nexport interface RankRadarAsin {\n  id: string;\n  krtId: string;\n  asin: string;\n}\n\nexport interface RankRadarItem {\n  id: string;\n  asin: RankRadarAsin;\n  marketplace: string;\n  keywordCount: number;\n  title: string;\n  imageUrl: string;\n  top10KW: number | null;\n  top10SV: number | null;\n  top50KW: number | null;\n  top50SV: number | null;\n}\n\nexport type RankRadarList = PaginationResponse<RankRadarItem>;\n\n/** Allowed values for the `status` query param on /v1/niches/rank-radars. */\nexport const RANK_RADAR_STATUSES = [\"ACTIVE\", \"PAUSED\", \"ARCHIVED\"] as const;\nexport type RankRadarStatus = (typeof RANK_RADAR_STATUSES)[number];\n\n// ─── /v1/niches/rank-radars/:rankRadarId  (KrtKeywordResponseDto[], wrapped) ─\n\nexport interface KrtAsinRank {\n  /** ISO date string. */\n  date: string;\n  organicRank?: number | null;\n  impressionRank?: number | null;\n}\n\nexport interface KrtKeyword {\n  id: string;\n  keyword: string;\n  searchVolume: number | null;\n  ranks: KrtAsinRank[];\n  /** Highlight annotations (KrtHighlightDto in backend); kept opaque for MVP. */\n  highlights: Array<Record<string, unknown>>;\n}\n\nexport type RankRadarKeywordList = KrtKeyword[];\n\n// ─── /v1/sellers/:sellerId/marketplaces/:marketplace/asins/:asin/inventory ────\n//      (InventoryByFcResponseDto, wrapped)\n\nexport interface InventoryByFcItem {\n  /** Fulfillment center code. */\n  fc: string;\n  /** State or region code where the FC is located, when known. */\n  state: string;\n  /** Units of sellable inventory currently at this FC. May be 0 when stock is out. */\n  availableStock: number;\n  /** Share of the ASIN's total sellable inventory at this FC, as a 0..1 fraction. */\n  availableStockPercentage: number;\n}\n\nexport interface InventoryByFcResponse {\n  asin: string;\n  sellerId: string;\n  /** Marketplace enum: \"com\", \"ca\", \"co.uk\", \"com.mx\", \"in\", \"fr\", \"de\", \"es\", \"it\", \"co.jp\". */\n  marketplace: string;\n  /** ISO timestamp of last successful ingestion. Null if none in the last 30 days. */\n  lastUpdatedAt: string | null;\n  totalSellableUnits: number;\n  distribution: InventoryByFcItem[];\n}\n","import { z } from \"zod\";\nimport { httpGet } from \"../http/client.js\";\nimport type { RankRadarKeywordList } from \"../types/api.js\";\nimport type { ToolDefinition } from \"./types.js\";\n\n/** yyyy-mm-dd matcher used by both startDate and endDate. */\nconst ISO_DATE = /^\\d{4}-\\d{2}-\\d{2}$/;\n\nconst inputSchema = {\n  rankRadarId: z\n    .string()\n    .uuid()\n    .describe(\"The Rank Radar UUID (from `list_rank_radars`).\"),\n  startDate: z\n    .string()\n    .regex(ISO_DATE, \"startDate must be in yyyy-mm-dd format\")\n    .describe(\"Start date for the ranking data range, yyyy-mm-dd (e.g. 2024-03-26).\"),\n  endDate: z\n    .string()\n    .regex(ISO_DATE, \"endDate must be in yyyy-mm-dd format\")\n    .describe(\"End date for the ranking data range, yyyy-mm-dd (e.g. 2024-04-26). Must be on or after startDate.\"),\n};\n\nexport const getRankRadarDataTool: ToolDefinition<typeof inputSchema> = {\n  name: \"get_rank_radar_data\",\n  title: \"Get Keyword Rankings for a Rank Radar\",\n  description:\n    \"Use this to analyze keyword ranking trends over time. Requires startDate and endDate (yyyy-mm-dd). \" +\n    \"Retrieves historical keyword ranking data for the specified Rank Radar within the date range. \" +\n    \"Returns an array of tracked keywords; each has id, keyword, searchVolume, ranks (per-day \" +\n    \"{ date, organicRank, impressionRank }), and any highlight annotations. Use after \" +\n    \"`list_rank_radars` to discover a `rankRadarId`.\",\n  inputSchema,\n  handler: async (args, ctx) => {\n    return await httpGet<RankRadarKeywordList>(\n      { config: ctx.config, toolName: \"get_rank_radar_data\" },\n      `/v1/niches/rank-radars/${encodeURIComponent(args.rankRadarId)}`,\n      { startDate: args.startDate, endDate: args.endDate },\n    );\n  },\n};\n","import { z } from \"zod\";\nimport { httpGet } from \"../http/client.js\";\nimport type { InventoryByFcResponse } from \"../types/api.js\";\nimport type { ToolDefinition } from \"./types.js\";\n\nconst inputSchema = {\n  sellerId: z\n    .string()\n    .min(1)\n    .describe(\n      \"Amazon seller account ID as connected to DataDive. Find it on the Connections page at https://2.datadive.tools — there is no MCP discovery tool for sellers yet.\",\n    ),\n  marketplace: z\n    .enum([\"com\", \"ca\", \"co.uk\", \"com.mx\", \"in\", \"fr\", \"de\", \"es\", \"it\", \"co.jp\"])\n    .describe('Amazon marketplace code, e.g. \"com\" for amazon.com or \"co.uk\" for amazon.co.uk.'),\n  asin: z\n    .string()\n    .regex(/^[A-Z0-9]{10}$/, \"ASIN must be 10 uppercase alphanumeric characters (e.g. B08XYZ1234).\")\n    .describe(\n      \"Amazon Standard Identification Number (10 uppercase alphanumeric characters, e.g. B08XYZ1234).\",\n    ),\n};\n\nexport const getAsinInventoryDistributionTool: ToolDefinition<typeof inputSchema> = {\n  name: \"get_asin_inventory_distribution\",\n  title: \"Get Per-Fulfillment-Center Inventory Distribution for an ASIN\",\n  description:\n    \"Use this when the user asks about inventory levels, stock by fulfillment center, \" +\n    \"or where their units are sitting across Amazon's fulfillment network for a specific ASIN. \" +\n    \"Requires the Amazon sellerId from the user's DataDive Connections page \" +\n    \"(https://2.datadive.tools), the marketplace code, and the ASIN. Returns totalSellableUnits \" +\n    \"and a per-FC `distribution` array (fc, state, availableStock, availableStockPercentage). \" +\n    \"`lastUpdatedAt` may be null when no successful inventory ingestion has occurred in the last 30 days.\",\n  inputSchema,\n  handler: async (args, ctx) => {\n    return await httpGet<InventoryByFcResponse>(\n      { config: ctx.config, toolName: \"get_asin_inventory_distribution\" },\n      `/v1/sellers/${encodeURIComponent(args.sellerId)}/marketplaces/${encodeURIComponent(\n        args.marketplace,\n      )}/asins/${encodeURIComponent(args.asin)}/inventory`,\n    );\n  },\n};\n","/**\n * Tool registry. The order here is the order tools appear in `tools/list`\n * over the MCP transport, which biases LLM discovery — keep \"discovery\" tools\n * (the ones that return IDs needed by other tools) at the top.\n */\n\nimport { listNichesTool } from \"./list-niches.js\";\nimport { getNicheKeywordsTool } from \"./get-niche-keywords.js\";\nimport { getNicheCompetitorsTool } from \"./get-niche-competitors.js\";\nimport { getRankingJuiceTool } from \"./get-ranking-juice.js\";\nimport { listRankRadarsTool } from \"./list-rank-radars.js\";\nimport { getRankRadarDataTool } from \"./get-rank-radar-data.js\";\nimport { getAsinInventoryDistributionTool } from \"./get-asin-inventory-distribution.js\";\nimport type { AnyTool } from \"./types.js\";\n\n// Note on the cast: each ToolDefinition<S> has a handler typed to its specific\n// schema; the registry needs a uniform shape. The MCP SDK validates incoming\n// args against `inputSchema` before calling the handler, so the cast is safe.\nexport const allTools: ReadonlyArray<AnyTool> = [\n  listNichesTool,\n  getNicheKeywordsTool,\n  getNicheCompetitorsTool,\n  getRankingJuiceTool,\n  listRankRadarsTool,\n  getRankRadarDataTool,\n  getAsinInventoryDistributionTool,\n] as unknown as ReadonlyArray<AnyTool>;\n\nexport type { ToolDefinition, AnyTool } from \"./types.js\";\n"],"mappings":"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","names":["KEY_HELP_URL","z","inputSchema","z","z","inputSchema","z","z","inputSchema","z","z","inputSchema","z","z","inputSchema","z","z","inputSchema","z"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@datadive-tools/mcp",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "MCP server for DataDive — query your niches, keywords, competitors, and Rank Radar data from Claude Desktop, Claude Code, or Cursor.",
   "type": "module",
   "bin": {
@@ -13,7 +13,7 @@
     "LICENSE"
   ],
   "engines": {
-    "node": ">=18.17"
+    "node": ">=22"
   },
   "scripts": {
     "build": "tsup",