mcp-server-peecai 0.2.0

package/dist/tools/chat-content.js

@@ -0,0 +1,23 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { PeecApiClient } from "../api-client.js";
+import { requireProjectId, toolResult, toolError } from "../util.js";
+/** Registers the get_chat_content tool for retrieving full chat details. */
+export function registerChatContentTool(server, client) {
+    server.tool("get_chat_content", "Get full content of a specific AI chat. Returns sources, brands mentioned, messages, queries, and products.", {
+        chat_id: z.string().regex(/^[\w-]+$/, "Invalid chat_id format").describe("Chat ID to retrieve"),
+        project_id: z.string().describe("Project ID (uses PEECAI_PROJECT_ID env if omitted). Call list_projects to find IDs.").optional(),
+    }, async ({ chat_id, project_id }) => {
+        try {
+            const data = await client.getRaw(`/chats/${chat_id}/content`, {
+                project_id: requireProjectId(project_id),
+            });
+            const _summary = `Chat ${chat_id}: ${data.messages.length} messages, ${data.sources.length} sources, ${data.brands_mentioned.length} brands`;
+            return toolResult({ _summary, chat: data });
+        }
+        catch (e) {
+            return toolError(e);
+        }
+    });
+}
+//# sourceMappingURL=chat-content.js.map

package/dist/tools/chat-content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-content.js","sourceRoot":"","sources":["../../src/tools/chat-content.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAGrE,4EAA4E;AAC5E,MAAM,UAAU,uBAAuB,CAAC,MAAiB,EAAE,MAAqB;IAC9E,MAAM,CAAC,IAAI,CACT,kBAAkB,EAClB,6GAA6G,EAC7G;QACE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,EAAE,wBAAwB,CAAC,CAAC,QAAQ,CAAC,qBAAqB,CAAC;QAC/F,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qFAAqF,CAAC,CAAC,QAAQ,EAAE;KAClI,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE,EAAE;QAChC,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,MAAM,CAAc,UAAU,OAAO,UAAU,EAAE;gBACzE,UAAU,EAAE,gBAAgB,CAAC,UAAU,CAAC;aACzC,CAAC,CAAC;YACH,MAAM,QAAQ,GAAG,QAAQ,OAAO,KAAK,IAAI,CAAC,QAAQ,CAAC,MAAM,cAAc,IAAI,CAAC,OAAO,CAAC,MAAM,aAAa,IAAI,CAAC,gBAAgB,CAAC,MAAM,SAAS,CAAC;YAC7I,OAAO,UAAU,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9C,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC;QACtB,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/chats.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { PeecApiClient } from "../api-client.js";
+/** Registers the list_chats tool for retrieving AI chat interactions with optional date filtering. */
+export declare function registerChatsTool(server: McpServer, client: PeecApiClient): void;

package/dist/tools/chats.js

@@ -0,0 +1,30 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { PeecApiClient } from "../api-client.js";
+import { requireProjectId, dateSchema, validateDateRange, summaryForList, toolResult, toolError } from "../util.js";
+/** Registers the list_chats tool for retrieving AI chat interactions with optional date filtering. */
+export function registerChatsTool(server, client) {
+    server.tool("list_chats", "List AI chat interactions tracked by Peec.ai. Returns up to limit results (default: 100). Always use date filters to scope results. Returns chat IDs, prompt/model refs, and dates. Without date filters, returns all chats.", {
+        project_id: z.string().describe("Project ID (uses PEECAI_PROJECT_ID env if omitted). Call list_projects to find IDs.").optional(),
+        start_date: dateSchema.describe("Start date filter (YYYY-MM-DD). Omit for no lower bound.").optional(),
+        end_date: dateSchema.describe("End date filter (YYYY-MM-DD). Omit for no upper bound.").optional(),
+        limit: z.number().min(1).max(10000).default(100).describe("Max results (1-10000, default: 100)").optional(),
+        offset: z.number().min(0).default(0).describe("Results to skip").optional(),
+    }, async ({ project_id, start_date, end_date, limit, offset }) => {
+        try {
+            const dates = validateDateRange(start_date, end_date);
+            const data = await client.get("/chats", {
+                project_id: requireProjectId(project_id),
+                start_date: dates.start_date,
+                end_date: dates.end_date,
+                limit,
+                offset,
+            });
+            return toolResult({ _summary: summaryForList("chats", data), chats: data });
+        }
+        catch (e) {
+            return toolError(e);
+        }
+    });
+}
+//# sourceMappingURL=chats.js.map

package/dist/tools/chats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chats.js","sourceRoot":"","sources":["../../src/tools/chats.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,iBAAiB,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAGpH,sGAAsG;AACtG,MAAM,UAAU,iBAAiB,CAAC,MAAiB,EAAE,MAAqB;IACxE,MAAM,CAAC,IAAI,CACT,YAAY,EACZ,8NAA8N,EAC9N;QACE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qFAAqF,CAAC,CAAC,QAAQ,EAAE;QACjI,UAAU,EAAE,UAAU,CAAC,QAAQ,CAAC,0DAA0D,CAAC,CAAC,QAAQ,EAAE;QACtG,QAAQ,EAAE,UAAU,CAAC,QAAQ,CAAC,wDAAwD,CAAC,CAAC,QAAQ,EAAE;QAClG,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,qCAAqC,CAAC,CAAC,QAAQ,EAAE;QAC3G,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC,QAAQ,EAAE;KAC5E,EACD,KAAK,EAAE,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE;QAC5D,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,iBAAiB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;YACtD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,GAAG,CAAS,QAAQ,EAAE;gBAC9C,UAAU,EAAE,gBAAgB,CAAC,UAAU,CAAC;gBACxC,UAAU,EAAE,KAAK,CAAC,UAAU;gBAC5B,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,KAAK;gBACL,MAAM;aACP,CAAC,CAAC;YACH,OAAO,UAAU,CAAC,EAAE,QAAQ,EAAE,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9E,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC;QACtB,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/models.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { PeecApiClient } from "../api-client.js";
+/** Registers the list_models tool for retrieving tracked AI models. */
+export declare function registerModelsTool(server: McpServer, client: PeecApiClient): void;

package/dist/tools/models.js

@@ -0,0 +1,25 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { PeecApiClient } from "../api-client.js";
+import { requireProjectId, summaryForList, toolResult, toolError } from "../util.js";
+/** Registers the list_models tool for retrieving tracked AI models. */
+export function registerModelsTool(server, client) {
+    server.tool("list_models", "List AI models tracked by Peec.ai (ChatGPT, Perplexity, etc.). Returns model IDs and active status.", {
+        project_id: z.string().describe("Project ID (uses PEECAI_PROJECT_ID env if omitted). Call list_projects to find IDs.").optional(),
+        limit: z.number().min(1).max(10000).default(1000).describe("Max results (1-10000)").optional(),
+        offset: z.number().min(0).default(0).describe("Results to skip").optional(),
+    }, async ({ project_id, limit, offset }) => {
+        try {
+            const data = await client.get("/models", {
+                project_id: requireProjectId(project_id),
+                limit,
+                offset,
+            });
+            return toolResult({ _summary: summaryForList("models", data), models: data });
+        }
+        catch (e) {
+            return toolError(e);
+        }
+    });
+}
+//# sourceMappingURL=models.js.map

package/dist/tools/models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../../src/tools/models.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAGrF,uEAAuE;AACvE,MAAM,UAAU,kBAAkB,CAAC,MAAiB,EAAE,MAAqB;IACzE,MAAM,CAAC,IAAI,CACT,aAAa,EACb,qGAAqG,EACrG;QACE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qFAAqF,CAAC,CAAC,QAAQ,EAAE;QACjI,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,uBAAuB,CAAC,CAAC,QAAQ,EAAE;QAC9F,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC,QAAQ,EAAE;KAC5E,EACD,KAAK,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE;QACtC,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,GAAG,CAAU,SAAS,EAAE;gBAChD,UAAU,EAAE,gBAAgB,CAAC,UAAU,CAAC;gBACxC,KAAK;gBACL,MAAM;aACP,CAAC,CAAC;YACH,OAAO,UAAU,CAAC,EAAE,QAAQ,EAAE,cAAc,CAAC,QAAQ,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QAChF,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC;QACtB,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/projects.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { PeecApiClient } from "../api-client.js";
+/** Registers the list_projects tool for retrieving all company projects. */
+export declare function registerProjectsTool(server: McpServer, client: PeecApiClient): void;

package/dist/tools/projects.js

@@ -0,0 +1,20 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { PeecApiClient } from "../api-client.js";
+import { summaryForList, toolResult, toolError } from "../util.js";
+/** Registers the list_projects tool for retrieving all company projects. */
+export function registerProjectsTool(server, client) {
+    server.tool("list_projects", "List all Peec.ai projects for the company. Returns project IDs, names, and statuses. Status values: CUSTOMER (active, ongoing monitoring), CUSTOMER_ENDED, PITCH (active demo), PITCH_ENDED (completed demo), TRIAL, TRIAL_ENDED, ONBOARDING, DELETED. Use CUSTOMER projects for current data.", {
+        limit: z.number().min(1).max(10000).default(1000).describe("Max results to return (1-10000)").optional(),
+        offset: z.number().min(0).default(0).describe("Number of results to skip").optional(),
+    }, async ({ limit, offset }) => {
+        try {
+            const data = await client.get("/projects", { limit, offset });
+            return toolResult({ _summary: summaryForList("projects", data), projects: data });
+        }
+        catch (e) {
+            return toolError(e);
+        }
+    });
+}
+//# sourceMappingURL=projects.js.map

package/dist/tools/projects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects.js","sourceRoot":"","sources":["../../src/tools/projects.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAGnE,4EAA4E;AAC5E,MAAM,UAAU,oBAAoB,CAAC,MAAiB,EAAE,MAAqB;IAC3E,MAAM,CAAC,IAAI,CACT,eAAe,EACf,gSAAgS,EAChS;QACE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,iCAAiC,CAAC,CAAC,QAAQ,EAAE;QACxG,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,2BAA2B,CAAC,CAAC,QAAQ,EAAE;KACtF,EACD,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE;QAC1B,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,GAAG,CAAY,WAAW,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;YACzE,OAAO,UAAU,CAAC,EAAE,QAAQ,EAAE,cAAc,CAAC,UAAU,EAAE,IAAI,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QACpF,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC;QACtB,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/prompts.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { PeecApiClient } from "../api-client.js";
+/** Registers the list_prompts tool for retrieving search prompts with metadata. */
+export declare function registerPromptsTool(server: McpServer, client: PeecApiClient): void;

package/dist/tools/prompts.js

@@ -0,0 +1,25 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { PeecApiClient } from "../api-client.js";
+import { requireProjectId, summaryForList, toolResult, toolError } from "../util.js";
+/** Registers the list_prompts tool for retrieving search prompts with metadata. */
+export function registerPromptsTool(server, client) {
+    server.tool("list_prompts", "List search prompts for a Peec.ai project. Returns prompt IDs, messages, tags, topics, locations, and search volume.", {
+        project_id: z.string().describe("Project ID (uses PEECAI_PROJECT_ID env if omitted). Call list_projects to find IDs.").optional(),
+        limit: z.number().min(1).max(10000).default(1000).describe("Max results (1-10000)").optional(),
+        offset: z.number().min(0).default(0).describe("Results to skip").optional(),
+    }, async ({ project_id, limit, offset }) => {
+        try {
+            const data = await client.get("/prompts", {
+                project_id: requireProjectId(project_id),
+                limit,
+                offset,
+            });
+            return toolResult({ _summary: summaryForList("prompts", data), prompts: data });
+        }
+        catch (e) {
+            return toolError(e);
+        }
+    });
+}
+//# sourceMappingURL=prompts.js.map

package/dist/tools/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../src/tools/prompts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAGrF,mFAAmF;AACnF,MAAM,UAAU,mBAAmB,CAAC,MAAiB,EAAE,MAAqB;IAC1E,MAAM,CAAC,IAAI,CACT,cAAc,EACd,sHAAsH,EACtH;QACE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qFAAqF,CAAC,CAAC,QAAQ,EAAE;QACjI,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,uBAAuB,CAAC,CAAC,QAAQ,EAAE;QAC9F,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC,QAAQ,EAAE;KAC5E,EACD,KAAK,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE;QACtC,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,GAAG,CAAW,UAAU,EAAE;gBAClD,UAAU,EAAE,gBAAgB,CAAC,UAAU,CAAC;gBACxC,KAAK;gBACL,MAAM;aACP,CAAC,CAAC;YACH,OAAO,UAAU,CAAC,EAAE,QAAQ,EAAE,cAAc,CAAC,SAAS,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAClF,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC;QACtB,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/report-brands.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { PeecApiClient } from "../api-client.js";
+/** Registers the get_brands_report tool for brand visibility, sentiment, and position analytics. */
+export declare function registerBrandsReportTool(server: McpServer, client: PeecApiClient): void;

package/dist/tools/report-brands.js

@@ -0,0 +1,47 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { PeecApiClient } from "../api-client.js";
+import { requireProjectId, dateSchema, dimensionsSchema, filterSchema, mergeFilters, validateDateRange, slimReportRows, summaryForBrandsReport, toolResult, toolError } from "../util.js";
+const BRANDS_FILTER_FIELDS = ["model_id", "tag_id", "topic_id", "prompt_id", "brand_id"];
+/** Registers the get_brands_report tool for brand visibility, sentiment, and position analytics. */
+export function registerBrandsReportTool(server, client) {
+    server.tool("get_brands_report", "Get brand analytics report per brand. Metrics: visibility (visibility_count/visibility_total), share_of_voice (0-1), mention_count, sentiment (0-100 scale, 50=neutral), position (avg rank when mentioned, lower=better). Returns up to limit results (default: 100). Use brand_id shortcut or filters array for server-side filtering. Supports date filtering and dimensional breakdowns. Without date filters, returns data across all available dates.", {
+        project_id: z.string().describe("Project ID (uses PEECAI_PROJECT_ID env if omitted). Call list_projects to find IDs.").optional(),
+        start_date: dateSchema.describe("Start date (YYYY-MM-DD). Omit for no lower bound.").optional(),
+        end_date: dateSchema.describe("End date (YYYY-MM-DD). Omit for no upper bound.").optional(),
+        dimensions: dimensionsSchema.optional(),
+        brand_id: z.string()
+            .describe("Convenience filter for a single brand (converted to server-side filter). Use list_brands to find IDs.")
+            .optional(),
+        filters: filterSchema(BRANDS_FILTER_FIELDS).optional(),
+        limit: z.number().min(1).max(10000).default(100).describe("Max results (1-10000, default: 100)").optional(),
+        offset: z.number().min(0).default(0).describe("Results to skip").optional(),
+    }, async ({ project_id, start_date, end_date, dimensions, brand_id, filters, limit, offset }) => {
+        try {
+            const dates = validateDateRange(start_date, end_date);
+            const body = {
+                project_id: requireProjectId(project_id),
+            };
+            if (dates.start_date)
+                body.start_date = dates.start_date;
+            if (dates.end_date)
+                body.end_date = dates.end_date;
+            if (dimensions)
+                body.dimensions = dimensions;
+            if (limit !== undefined)
+                body.limit = limit;
+            if (offset !== undefined)
+                body.offset = offset;
+            const merged = mergeFilters(filters, { field: "brand_id", value: brand_id });
+            if (merged)
+                body.filters = merged;
+            const data = await client.post("/reports/brands", body);
+            const rows = slimReportRows(data);
+            return toolResult({ _summary: summaryForBrandsReport(rows), rows });
+        }
+        catch (e) {
+            return toolError(e);
+        }
+    });
+}
+//# sourceMappingURL=report-brands.js.map

package/dist/tools/report-brands.js.map

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

package/dist/tools/report-domains.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { PeecApiClient } from "../api-client.js";
+/** Registers the get_domains_report tool for domain classification, usage, and citation analytics. */
+export declare function registerDomainsReportTool(server: McpServer, client: PeecApiClient): void;

package/dist/tools/report-domains.js

@@ -0,0 +1,47 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { PeecApiClient } from "../api-client.js";
+import { requireProjectId, dateSchema, dimensionsSchema, filterSchema, mergeFilters, validateDateRange, slimReportRows, summaryForDomainsReport, toolResult, toolError } from "../util.js";
+const DOMAINS_FILTER_FIELDS = ["model_id", "tag_id", "topic_id", "prompt_id", "domain", "url"];
+/** Registers the get_domains_report tool for domain classification, usage, and citation analytics. */
+export function registerDomainsReportTool(server, client) {
+    server.tool("get_domains_report", "Get domain analytics report: usage_rate (0-1, share of chats citing this domain) and citation_avg (avg citations per chat). Classification values: OWN, CORPORATE, COMPETITOR, EDITORIAL, REFERENCE, INSTITUTIONAL, UGC, OTHER. Returns up to limit results (default: 100). Use classification shortcut or filters array for server-side filtering. Without date filters, returns data across all available dates.", {
+        project_id: z.string().describe("Project ID (uses PEECAI_PROJECT_ID env if omitted). Call list_projects to find IDs.").optional(),
+        start_date: dateSchema.describe("Start date (YYYY-MM-DD). Omit for no lower bound.").optional(),
+        end_date: dateSchema.describe("End date (YYYY-MM-DD). Omit for no upper bound.").optional(),
+        dimensions: dimensionsSchema.optional(),
+        classification: z.enum(["OWN", "CORPORATE", "COMPETITOR", "EDITORIAL", "REFERENCE", "INSTITUTIONAL", "UGC", "OTHER"])
+            .describe("Convenience filter by domain classification (converted to server-side filter).")
+            .optional(),
+        filters: filterSchema(DOMAINS_FILTER_FIELDS).optional(),
+        limit: z.number().min(1).max(10000).default(100).describe("Max results (1-10000, default: 100)").optional(),
+        offset: z.number().min(0).default(0).describe("Results to skip").optional(),
+    }, async ({ project_id, start_date, end_date, dimensions, classification, filters, limit, offset }) => {
+        try {
+            const dates = validateDateRange(start_date, end_date);
+            const body = {
+                project_id: requireProjectId(project_id),
+            };
+            if (dates.start_date)
+                body.start_date = dates.start_date;
+            if (dates.end_date)
+                body.end_date = dates.end_date;
+            if (dimensions)
+                body.dimensions = dimensions;
+            if (limit !== undefined)
+                body.limit = limit;
+            if (offset !== undefined)
+                body.offset = offset;
+            const merged = mergeFilters(filters, { field: "classification", value: classification });
+            if (merged)
+                body.filters = merged;
+            const data = await client.post("/reports/domains", body);
+            const rows = slimReportRows(data);
+            return toolResult({ _summary: summaryForDomainsReport(rows), rows });
+        }
+        catch (e) {
+            return toolError(e);
+        }
+    });
+}
+//# sourceMappingURL=report-domains.js.map

package/dist/tools/report-domains.js.map

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

package/dist/tools/report-urls.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { PeecApiClient } from "../api-client.js";
+/** Registers the get_urls_report tool for URL classification, usage, and citation analytics. */
+export declare function registerUrlsReportTool(server: McpServer, client: PeecApiClient): void;

package/dist/tools/report-urls.js

@@ -0,0 +1,47 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { PeecApiClient } from "../api-client.js";
+import { requireProjectId, dateSchema, dimensionsSchema, filterSchema, mergeFilters, validateDateRange, slimReportRows, summaryForUrlsReport, toolResult, toolError } from "../util.js";
+const URLS_FILTER_FIELDS = ["model_id", "tag_id", "topic_id", "prompt_id", "domain", "url"];
+/** Registers the get_urls_report tool for URL classification, usage, and citation analytics. */
+export function registerUrlsReportTool(server, client) {
+    server.tool("get_urls_report", "Get URL analytics report: usage_count (chats citing this URL), citation_count (total citations), citation_avg (avg citations per chat). Classification values: HOMEPAGE, CATEGORY_PAGE, PRODUCT_PAGE, LISTICLE, COMPARISON, PROFILE, ALTERNATIVE, DISCUSSION, HOW_TO_GUIDE, ARTICLE, OTHER. Returns up to limit results (default: 100). Use classification shortcut or filters array for server-side filtering. Without date filters, returns data across all available dates.", {
+        project_id: z.string().describe("Project ID (uses PEECAI_PROJECT_ID env if omitted). Call list_projects to find IDs.").optional(),
+        start_date: dateSchema.describe("Start date (YYYY-MM-DD). Omit for no lower bound.").optional(),
+        end_date: dateSchema.describe("End date (YYYY-MM-DD). Omit for no upper bound.").optional(),
+        dimensions: dimensionsSchema.optional(),
+        classification: z.enum(["HOMEPAGE", "CATEGORY_PAGE", "PRODUCT_PAGE", "LISTICLE", "COMPARISON", "PROFILE", "ALTERNATIVE", "DISCUSSION", "HOW_TO_GUIDE", "ARTICLE", "OTHER"])
+            .describe("Convenience filter by URL classification (converted to server-side filter).")
+            .optional(),
+        filters: filterSchema(URLS_FILTER_FIELDS).optional(),
+        limit: z.number().min(1).max(10000).default(100).describe("Max results (1-10000, default: 100)").optional(),
+        offset: z.number().min(0).default(0).describe("Results to skip").optional(),
+    }, async ({ project_id, start_date, end_date, dimensions, classification, filters, limit, offset }) => {
+        try {
+            const dates = validateDateRange(start_date, end_date);
+            const body = {
+                project_id: requireProjectId(project_id),
+            };
+            if (dates.start_date)
+                body.start_date = dates.start_date;
+            if (dates.end_date)
+                body.end_date = dates.end_date;
+            if (dimensions)
+                body.dimensions = dimensions;
+            if (limit !== undefined)
+                body.limit = limit;
+            if (offset !== undefined)
+                body.offset = offset;
+            const merged = mergeFilters(filters, { field: "classification", value: classification });
+            if (merged)
+                body.filters = merged;
+            const data = await client.post("/reports/urls", body);
+            const rows = slimReportRows(data);
+            return toolResult({ _summary: summaryForUrlsReport(rows), rows });
+        }
+        catch (e) {
+            return toolError(e);
+        }
+    });
+}
+//# sourceMappingURL=report-urls.js.map

package/dist/tools/report-urls.js.map

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

package/dist/tools/tags.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { PeecApiClient } from "../api-client.js";
+/** Registers the list_tags tool for retrieving category tags. */
+export declare function registerTagsTool(server: McpServer, client: PeecApiClient): void;

package/dist/tools/tags.js

@@ -0,0 +1,25 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { PeecApiClient } from "../api-client.js";
+import { requireProjectId, summaryForList, toolResult, toolError } from "../util.js";
+/** Registers the list_tags tool for retrieving category tags. */
+export function registerTagsTool(server, client) {
+    server.tool("list_tags", "List category tags for a Peec.ai project. Returns tag IDs and names.", {
+        project_id: z.string().describe("Project ID (uses PEECAI_PROJECT_ID env if omitted). Call list_projects to find IDs.").optional(),
+        limit: z.number().min(1).max(10000).default(1000).describe("Max results (1-10000)").optional(),
+        offset: z.number().min(0).default(0).describe("Results to skip").optional(),
+    }, async ({ project_id, limit, offset }) => {
+        try {
+            const data = await client.get("/tags", {
+                project_id: requireProjectId(project_id),
+                limit,
+                offset,
+            });
+            return toolResult({ _summary: summaryForList("tags", data), tags: data });
+        }
+        catch (e) {
+            return toolError(e);
+        }
+    });
+}
+//# sourceMappingURL=tags.js.map

package/dist/tools/tags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tags.js","sourceRoot":"","sources":["../../src/tools/tags.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAGrF,iEAAiE;AACjE,MAAM,UAAU,gBAAgB,CAAC,MAAiB,EAAE,MAAqB;IACvE,MAAM,CAAC,IAAI,CACT,WAAW,EACX,sEAAsE,EACtE;QACE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qFAAqF,CAAC,CAAC,QAAQ,EAAE;QACjI,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,uBAAuB,CAAC,CAAC,QAAQ,EAAE;QAC9F,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC,QAAQ,EAAE;KAC5E,EACD,KAAK,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE;QACtC,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,GAAG,CAAQ,OAAO,EAAE;gBAC5C,UAAU,EAAE,gBAAgB,CAAC,UAAU,CAAC;gBACxC,KAAK;gBACL,MAAM;aACP,CAAC,CAAC;YACH,OAAO,UAAU,CAAC,EAAE,QAAQ,EAAE,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5E,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC;QACtB,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/topics.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { PeecApiClient } from "../api-client.js";
+/** Registers the list_topics tool for retrieving topic groupings. */
+export declare function registerTopicsTool(server: McpServer, client: PeecApiClient): void;

package/dist/tools/topics.js

@@ -0,0 +1,25 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { PeecApiClient } from "../api-client.js";
+import { requireProjectId, summaryForList, toolResult, toolError } from "../util.js";
+/** Registers the list_topics tool for retrieving topic groupings. */
+export function registerTopicsTool(server, client) {
+    server.tool("list_topics", "List topic groupings for a Peec.ai project. Returns topic IDs and names.", {
+        project_id: z.string().describe("Project ID (uses PEECAI_PROJECT_ID env if omitted). Call list_projects to find IDs.").optional(),
+        limit: z.number().min(1).max(10000).default(1000).describe("Max results (1-10000)").optional(),
+        offset: z.number().min(0).default(0).describe("Results to skip").optional(),
+    }, async ({ project_id, limit, offset }) => {
+        try {
+            const data = await client.get("/topics", {
+                project_id: requireProjectId(project_id),
+                limit,
+                offset,
+            });
+            return toolResult({ _summary: summaryForList("topics", data), topics: data });
+        }
+        catch (e) {
+            return toolError(e);
+        }
+    });
+}
+//# sourceMappingURL=topics.js.map

package/dist/tools/topics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"topics.js","sourceRoot":"","sources":["../../src/tools/topics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAGrF,qEAAqE;AACrE,MAAM,UAAU,kBAAkB,CAAC,MAAiB,EAAE,MAAqB;IACzE,MAAM,CAAC,IAAI,CACT,aAAa,EACb,0EAA0E,EAC1E;QACE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qFAAqF,CAAC,CAAC,QAAQ,EAAE;QACjI,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,uBAAuB,CAAC,CAAC,QAAQ,EAAE;QAC9F,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC,QAAQ,EAAE;KAC5E,EACD,KAAK,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE;QACtC,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,GAAG,CAAU,SAAS,EAAE;gBAChD,UAAU,EAAE,gBAAgB,CAAC,UAAU,CAAC;gBACxC,KAAK;gBACL,MAAM;aACP,CAAC,CAAC;YACH,OAAO,UAAU,CAAC,EAAE,QAAQ,EAAE,cAAc,CAAC,QAAQ,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QAChF,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC;QACtB,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,149 @@
+/** Standard Peec.ai API envelope — most list/report endpoints wrap results in `{ data: T }`. */
+export interface ApiResponse<T> {
+    data: T;
+}
+/** A Peec.ai project representing a tracked brand or campaign. */
+export interface Project {
+    id: string;
+    name: string;
+    status: ProjectStatus;
+}
+export type ProjectStatus = "CUSTOMER" | "CUSTOMER_ENDED" | "PITCH" | "PITCH_ENDED" | "TRIAL" | "TRIAL_ENDED" | "ONBOARDING" | "DELETED";
+/** A brand being tracked within a project, with its associated domains. */
+export interface Brand {
+    id: string;
+    name: string;
+    domains?: string[];
+}
+export interface PromptMessage {
+    content: string;
+}
+/** A search prompt that Peec.ai monitors across AI models. */
+export interface Prompt {
+    id: string;
+    messages: PromptMessage[];
+    tags: DimensionRef[];
+    topic: DimensionRef | null;
+    user_location: {
+        country: string;
+    };
+    /** Estimated monthly search volume. */
+    volume?: number;
+}
+export interface Tag {
+    id: string;
+    name: string;
+}
+export interface Topic {
+    id: string;
+    name: string;
+}
+/** An AI model tracked by Peec.ai (e.g. ChatGPT, Perplexity). */
+export interface Model {
+    id: string;
+    is_active: boolean;
+}
+/** Summary of a single AI chat interaction. */
+export interface Chat {
+    id: string;
+    prompt: DimensionRef;
+    model: DimensionRef;
+    date: string;
+}
+/** A source URL cited in an AI chat response. */
+export interface ChatSource {
+    url: string;
+    /** Normalized URL for deduplication; null if normalization was not possible. */
+    urlNormalized: string | null;
+    domain: string;
+    citationCount: number;
+    /** Position of this citation in the response (1-based). */
+    citationPosition: number;
+}
+export interface ChatBrandMentioned {
+    id: string;
+    name: string;
+    /** Position of this brand mention in the response (1-based). */
+    position: number;
+}
+export interface ChatMessage {
+    role: "user" | "assistant";
+    content: string;
+}
+export interface ChatProduct {
+    name: string;
+    queries: string[];
+}
+/** Full content of an AI chat including sources, brands, messages, and extracted products. */
+export interface ChatContent {
+    id: string;
+    prompt: DimensionRef;
+    model: DimensionRef;
+    sources: ChatSource[];
+    brands_mentioned: ChatBrandMentioned[];
+    messages: ChatMessage[];
+    queries: string[];
+    products: ChatProduct[];
+}
+/** Lightweight reference to a dimension entity (prompt, model, tag, or topic) by ID. */
+export interface DimensionRef {
+    id: string;
+}
+/** Brand analytics row from the /reports/brands endpoint. */
+export interface BrandReportRow {
+    brand: {
+        id: string;
+        name: string;
+    };
+    prompt?: DimensionRef;
+    model?: DimensionRef;
+    tag?: DimensionRef;
+    topic?: DimensionRef;
+    /** Ratio 0–1: visibility_count / visibility_total. */
+    visibility: number;
+    visibility_count: number;
+    visibility_total: number;
+    /** Share of voice 0–1: proportion of total brand mentions. */
+    share_of_voice: number;
+    /** Number of times this brand was mentioned. */
+    mention_count: number;
+    /** Sentiment score 0–100 (50 = neutral). Absent when no sentiment data. */
+    sentiment?: number;
+    sentiment_sum?: number;
+    sentiment_count?: number;
+    /** Average position when mentioned (lower = better). Absent when no position data. */
+    position?: number;
+    position_sum?: number;
+    position_count?: number;
+}
+export type DomainClassification = "UGC" | "CORPORATE" | "EDITORIAL" | "INSTITUTIONAL" | "OTHER" | "REFERENCE" | "COMPETITOR" | "OWN";
+export type UrlClassification = "HOMEPAGE" | "CATEGORY_PAGE" | "PRODUCT_PAGE" | "LISTICLE" | "COMPARISON" | "PROFILE" | "ALTERNATIVE" | "DISCUSSION" | "HOW_TO_GUIDE" | "ARTICLE" | "OTHER";
+/** Domain analytics row from the /reports/domains endpoint. */
+export interface DomainReportRow {
+    domain: string;
+    classification: DomainClassification | null;
+    prompt?: DimensionRef;
+    model?: DimensionRef;
+    tag?: DimensionRef;
+    topic?: DimensionRef;
+    /** Share of chats citing this domain (0–1). */
+    usage_rate?: number;
+    /** Average number of citations per chat. */
+    citation_avg: number;
+}
+/** URL analytics row from the /reports/urls endpoint. */
+export interface UrlReportRow {
+    url: string;
+    classification: UrlClassification;
+    title: string | null;
+    prompt?: DimensionRef;
+    model?: DimensionRef;
+    tag?: DimensionRef;
+    topic?: DimensionRef;
+    /** Number of chats citing this URL. */
+    usage_count: number;
+    /** Total citation count across all chats. */
+    citation_count: number;
+    /** Average citations per chat. */
+    citation_avg: number;
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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