@attrove/mcp 0.1.7 → 0.1.8

package/esm/tools/integrations.js

@@ -8,10 +8,10 @@
  */
 export const integrationsToolDefinition = {
     name: "attrove_integrations",
-    description: `List the user's connected integrations (Gmail, Slack, etc.).
+    description: `List the authenticated user's own connected integrations and their status.
 
-This tool shows which services the user has connected and their current status. Use this to:
-- Check what data sources are available for queries
+This read-only tool shows which services the user has explicitly connected to their account and each service's current status. Use this to:
+- Check what data sources the user has authorized
 - Verify integration status before searching
 - Help users understand their connected services
 
@@ -24,9 +24,16 @@ The response includes:
         properties: {},
         required: [],
     },
+    annotations: {
+        title: "List Integrations",
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: true,
+    },
 };
 /**
- * Execute the integrations tool.
+ * List all connected integrations and format them for MCP display.
  */
 export async function executeIntegrationsTool(client) {
     const integrations = await client.integrations.list();

package/esm/tools/integrations.js.map

@@ -1 +1 @@
-{"version":3,"file":"integrations.js","sourceRoot":"","sources":["../../../../../packages/mcp/src/tools/integrations.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EAAE;;;;;;;;;;uEAUwD;IACrE,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE,EAAE;QACd,QAAQ,EAAE,EAAE;KACb;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,MAAe;IAEf,MAAM,YAAY,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;IAEtD,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,OAAO,mGAAmG,CAAC;IAC7G,CAAC;IAED,IAAI,MAAM,GAAG,2BAA2B,YAAY,CAAC,MAAM,MAAM,CAAC;IAElE,KAAK,MAAM,WAAW,IAAI,YAAY,EAAE,CAAC;QACvC,MAAM,MAAM,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC;QACjE,MAAM,UAAU,GACd,WAAW,CAAC,WAAW,KAAK,WAAW;YACrC,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,KAAK,WAAW,CAAC,WAAW,GAAG,CAAC;QAEtC,MAAM,IAAI,SAAS,WAAW,CAAC,IAAI,OAAO,WAAW,CAAC,QAAQ,KAAK,CAAC;QACpE,MAAM,IAAI,WAAW,WAAW,CAAC,EAAE,IAAI,CAAC;QACxC,MAAM,IAAI,eAAe,MAAM,GAAG,UAAU,IAAI,CAAC;IACnD,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"integrations.js","sourceRoot":"","sources":["../../../../../packages/mcp/src/tools/integrations.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH;;GAEG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAS;IAC9C,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EAAE;;;;;;;;;;uEAUwD;IACrE,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,EAAE;QACd,QAAQ,EAAE,EAAE;KACb;IACD,WAAW,EAAE;QACX,KAAK,EAAE,mBAAmB;QAC1B,YAAY,EAAE,IAAI;QAClB,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,IAAI;KACpB;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,MAAe;IAEf,MAAM,YAAY,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;IAEtD,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,OAAO,mGAAmG,CAAC;IAC7G,CAAC;IAED,IAAI,MAAM,GAAG,2BAA2B,YAAY,CAAC,MAAM,MAAM,CAAC;IAElE,KAAK,MAAM,WAAW,IAAI,YAAY,EAAE,CAAC;QACvC,MAAM,MAAM,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC;QACjE,MAAM,UAAU,GACd,WAAW,CAAC,WAAW,KAAK,WAAW;YACrC,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,KAAK,WAAW,CAAC,WAAW,GAAG,CAAC;QAEtC,MAAM,IAAI,SAAS,WAAW,CAAC,IAAI,OAAO,WAAW,CAAC,QAAQ,KAAK,CAAC;QACpE,MAAM,IAAI,WAAW,WAAW,CAAC,EAAE,IAAI,CAAC;QACxC,MAAM,IAAI,eAAe,MAAM,GAAG,UAAU,IAAI,CAAC;IACnD,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/esm/tools/meetings.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Meetings Tool
+ *
+ * MCP tool for listing meetings with AI-generated summaries and action items.
+ */
+import { Tool } from "@modelcontextprotocol/sdk/types.js";
+import { Attrove, MeetingProvider } from "@attrove/sdk";
+/**
+ * MCP schema for discovering and filtering meetings with AI-generated summaries.
+ */
+export declare const meetingsToolDefinition: Tool;
+/**
+ * Validated input accepted by {@link executeMeetingsTool}.
+ */
+export interface MeetingsToolInput {
+    start_date?: string;
+    end_date?: string;
+    provider?: MeetingProvider;
+    limit?: number;
+}
+/**
+ * Fetch meetings via the SDK and format them as a human-readable summary
+ * including AI-generated summaries and action items.
+ */
+export declare function executeMeetingsTool(client: Attrove, input: MeetingsToolInput): Promise<string>;
+//# sourceMappingURL=meetings.d.ts.map

package/esm/tools/meetings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meetings.d.ts","sourceRoot":"","sources":["../../../../../packages/mcp/src/tools/meetings.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC1D,OAAO,EACL,OAAO,EAEP,eAAe,EAEhB,MAAM,cAAc,CAAC;AAEtB;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,IAyCpC,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AA+BD;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,OAAO,EACf,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAAC,MAAM,CAAC,CAgFjB"}

package/esm/tools/meetings.js

@@ -0,0 +1,146 @@
+/**
+ * Meetings Tool
+ *
+ * MCP tool for listing meetings with AI-generated summaries and action items.
+ */
+/**
+ * MCP schema for discovering and filtering meetings with AI-generated summaries.
+ */
+export const meetingsToolDefinition = {
+    name: "attrove_meetings",
+    description: `List meetings with AI-generated summaries and action items from the user's own connected accounts.
+
+This read-only tool returns meetings from the authenticated user's authorized meeting integrations (e.g., Google Meet, Zoom, Teams) with AI-generated summaries. Only meetings from services the user has explicitly connected are accessed. Use this when the user asks about:
+- "What happened in my last meeting?"
+- "Summarize yesterday's standup"
+- "What are the action items from the product review?"
+- "Show me my recent meetings"`,
+    inputSchema: {
+        type: "object",
+        properties: {
+            start_date: {
+                type: "string",
+                description: "Start of date range (ISO 8601). If omitted, the server determines the default.",
+            },
+            end_date: {
+                type: "string",
+                description: "End of date range (ISO 8601). If omitted, the server determines the default.",
+            },
+            provider: {
+                type: "string",
+                enum: ["google_meet", "zoom", "teams"],
+                description: "Optional: Filter by meeting provider",
+            },
+            limit: {
+                type: "number",
+                description: "Max meetings to return (default 10, max 50)",
+            },
+        },
+        required: [],
+    },
+    annotations: {
+        title: "Meeting Summaries",
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: true,
+    },
+};
+/**
+ * Format a meeting's time range for display.
+ * Returns a fallback string when the meeting contains unparseable dates.
+ */
+function formatMeetingTime(meeting) {
+    const start = new Date(meeting.start_time);
+    const end = new Date(meeting.end_time);
+    if (Number.isNaN(start.getTime()) || Number.isNaN(end.getTime())) {
+        return meeting.start_time ?? "Unknown time";
+    }
+    const dateStr = start.toLocaleDateString(undefined, {
+        weekday: "short",
+        month: "short",
+        day: "numeric",
+    });
+    const startTime = start.toLocaleTimeString(undefined, {
+        hour: "numeric",
+        minute: "2-digit",
+    });
+    const endTime = end.toLocaleTimeString(undefined, {
+        hour: "numeric",
+        minute: "2-digit",
+    });
+    return `${dateStr}, ${startTime} – ${endTime}`;
+}
+/**
+ * Fetch meetings via the SDK and format them as a human-readable summary
+ * including AI-generated summaries and action items.
+ */
+export async function executeMeetingsTool(client, input) {
+    const options = {
+        expand: ["summary", "short_summary", "action_items", "attendees"],
+    };
+    if (input.start_date) {
+        options.startDate = input.start_date;
+    }
+    if (input.end_date) {
+        options.endDate = input.end_date;
+    }
+    if (input.provider) {
+        options.provider = input.provider;
+    }
+    options.limit = Math.max(1, Math.min(input.limit ?? 10, 50));
+    const response = await client.meetings.list(options);
+    if (!response.data) {
+        // prettier-ignore
+        console.error("[AttroveMCP]", JSON.stringify({ level: "warn", msg: "Meetings API returned success but data was nullish", errorId: "MCP_MEETINGS_MALFORMED_RESPONSE" }));
+        return "The meetings API returned an unexpected response format. Please try again.";
+    }
+    if (response.data.length === 0) {
+        return "No meetings found for the specified date range.";
+    }
+    const meetings = response.data;
+    let result = `Found ${meetings.length} meeting(s):\n`;
+    for (const meeting of meetings) {
+        result += `\n### ${meeting.title}\n`;
+        result += `- **When:** ${formatMeetingTime(meeting)}\n`;
+        if (meeting.provider) {
+            const providerLabel = meeting.provider
+                .replace(/_/g, " ")
+                .replace(/\b\w/g, (c) => c.toUpperCase());
+            result += `- **Provider:** ${providerLabel}\n`;
+        }
+        if (meeting.attendees?.length) {
+            const attendeeList = meeting.attendees
+                .map((a) => {
+                const name = a.name || a.email || "Unknown";
+                const role = a.is_organizer ? " (organizer)" : "";
+                return `${name}${role}`;
+            })
+                .join(", ");
+            result += `- **Attendees:** ${attendeeList}\n`;
+        }
+        if (meeting.meeting_link) {
+            result += `- **Meeting link:** ${meeting.meeting_link}\n`;
+        }
+        if (meeting.summary) {
+            result += `\n**Summary:**\n${meeting.summary}\n`;
+        }
+        else if (meeting.short_summary) {
+            result += `\n**Summary:** ${meeting.short_summary}\n`;
+        }
+        if (meeting.action_items?.length) {
+            result += `\n**Action Items:**\n`;
+            for (const item of meeting.action_items) {
+                const assignee = item.assignee ? ` (${item.assignee})` : "";
+                const dueDate = item.due_date ? ` — due ${item.due_date}` : "";
+                const status = item.completed ? " [Done]" : "";
+                result += `- ${item.description}${assignee}${dueDate}${status}\n`;
+            }
+        }
+    }
+    if (response.pagination?.has_more) {
+        result += `\n_Showing ${meetings.length} of ${response.pagination.total_count ?? "more"} meetings. Adjust start_date, end_date, or limit to refine results._\n`;
+    }
+    return result;
+}
+//# sourceMappingURL=meetings.js.map

package/esm/tools/meetings.js.map

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

package/esm/tools/query.d.ts

@@ -3,36 +3,12 @@
  *
  * MCP tool for RAG queries against user context.
  */
+import { Tool } from "@modelcontextprotocol/sdk/types.js";
 import { Attrove } from "@attrove/sdk";
 /**
  * Tool definition for attrove_query.
  */
-export declare const queryToolDefinition: {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: "object";
-        properties: {
-            query: {
-                type: string;
-                description: string;
-            };
-            integration_ids: {
-                type: string;
-                items: {
-                    type: string;
-                };
-                description: string;
-            };
-            include_sources: {
-                type: string;
-                description: string;
-                default: boolean;
-            };
-        };
-        required: string[];
-    };
-};
+export declare const queryToolDefinition: Tool;
 /**
  * Input for the query tool.
  */
@@ -42,7 +18,7 @@ export interface QueryToolInput {
     include_sources?: boolean;
 }
 /**
- * Execute the query tool.
+ * Run a RAG query via the SDK and format the answer with optional sources.
  */
 export declare function executeQueryTool(client: Attrove, input: QueryToolInput): Promise<string>;
 //# sourceMappingURL=query.d.ts.map

package/esm/tools/query.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../../../packages/mcp/src/tools/query.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAA+B,MAAM,cAAc,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;CA+B/B,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,OAAO,EACf,KAAK,EAAE,cAAc,GACpB,OAAO,CAAC,MAAM,CAAC,CA2BjB"}
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../../../packages/mcp/src/tools/query.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC1D,OAAO,EAAE,OAAO,EAA+B,MAAM,cAAc,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,IAsCjC,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,OAAO,EACf,KAAK,EAAE,cAAc,GACpB,OAAO,CAAC,MAAM,CAAC,CA2BjB"}

package/esm/tools/query.js

@@ -8,15 +8,15 @@
  */
 export const queryToolDefinition = {
     name: "attrove_query",
-    description: `Ask a question about the user's communications and get an AI-generated answer.
+    description: `Ask a question and get an AI-generated answer from the user's own connected accounts.
 
-This tool searches across all connected integrations (Gmail, Slack, Google Meet, etc.) and returns a comprehensive answer based on the relevant context.
+This read-only tool searches the authenticated user's connected services (e.g., Gmail, Slack, Google Calendar) and returns an answer based on their own data. Only data the user has explicitly connected and authorized is accessed.
 
 Use this tool when the user asks questions like:
 - "What did Sarah say about the Q4 budget?"
 - "Summarize my meeting with the engineering team"
 - "What are the action items from yesterday's standup?"
-- "When is my next meeting with John?"`,
+- "What context do I need for my 3pm meeting?"`,
     inputSchema: {
         type: "object",
         properties: {
@@ -37,9 +37,16 @@ Use this tool when the user asks questions like:
         },
         required: ["query"],
     },
+    annotations: {
+        title: "Ask Attrove",
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: true,
+    },
 };
 /**
- * Execute the query tool.
+ * Run a RAG query via the SDK and format the answer with optional sources.
  */
 export async function executeQueryTool(client, input) {
     const options = {};
@@ -58,7 +65,7 @@ export async function executeQueryTool(client, input) {
             result += `\n- ${source.title}: "${source.snippet}"`;
         }
     }
-    if (response.used_message_ids.length > 0) {
+    if (response.used_message_ids?.length) {
         result += `\n\n_Based on ${response.used_message_ids.length} messages._`;
     }
     return result;

package/esm/tools/query.js.map

@@ -1 +1 @@
-{"version":3,"file":"query.js","sourceRoot":"","sources":["../../../../../packages/mcp/src/tools/query.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE;;;;;;;;uCAQwB;IACrC,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,8CAA8C;aAC5D;YACD,eAAe,EAAE;gBACf,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,sDAAsD;aACpE;YACD,eAAe,EAAE;gBACf,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,mDAAmD;gBAChE,OAAO,EAAE,KAAK;aACf;SACF;QACD,QAAQ,EAAE,CAAC,OAAO,CAAC;KACpB;CACF,CAAC;AAWF;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,MAAe,EACf,KAAqB;IAErB,MAAM,OAAO,GAAiB,EAAE,CAAC;IAEjC,IAAI,KAAK,CAAC,eAAe,EAAE,MAAM,EAAE,CAAC;QAClC,OAAO,CAAC,cAAc,GAAG,KAAK,CAAC,eAAe,CAAC;IACjD,CAAC;IACD,IAAI,KAAK,CAAC,eAAe,EAAE,CAAC;QAC1B,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAChC,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAE1D,8BAA8B;IAC9B,IAAI,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;IAE7B,IAAI,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;QAC7B,MAAM,IAAI,kBAAkB,CAAC;QAC7B,KAAK,MAAM,MAAM,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;YACtC,MAAM,IAAI,OAAO,MAAM,CAAC,KAAK,MAAM,MAAM,CAAC,OAAO,GAAG,CAAC;QACvD,CAAC;IACH,CAAC;IAED,IAAI,QAAQ,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,iBAAiB,QAAQ,CAAC,gBAAgB,CAAC,MAAM,aAAa,CAAC;IAC3E,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../../../../../packages/mcp/src/tools/query.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAS;IACvC,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE;;;;;;;;+CAQgC;IAC7C,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,8CAA8C;aAC5D;YACD,eAAe,EAAE;gBACf,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,sDAAsD;aACpE;YACD,eAAe,EAAE;gBACf,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,mDAAmD;gBAChE,OAAO,EAAE,KAAK;aACf;SACF;QACD,QAAQ,EAAE,CAAC,OAAO,CAAC;KACpB;IACD,WAAW,EAAE;QACX,KAAK,EAAE,aAAa;QACpB,YAAY,EAAE,IAAI;QAClB,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,IAAI;KACpB;CACF,CAAC;AAWF;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,MAAe,EACf,KAAqB;IAErB,MAAM,OAAO,GAAiB,EAAE,CAAC;IAEjC,IAAI,KAAK,CAAC,eAAe,EAAE,MAAM,EAAE,CAAC;QAClC,OAAO,CAAC,cAAc,GAAG,KAAK,CAAC,eAAe,CAAC;IACjD,CAAC;IACD,IAAI,KAAK,CAAC,eAAe,EAAE,CAAC;QAC1B,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAChC,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAE1D,8BAA8B;IAC9B,IAAI,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;IAE7B,IAAI,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;QAC7B,MAAM,IAAI,kBAAkB,CAAC;QAC7B,KAAK,MAAM,MAAM,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;YACtC,MAAM,IAAI,OAAO,MAAM,CAAC,KAAK,MAAM,MAAM,CAAC,OAAO,GAAG,CAAC;QACvD,CAAC;IACH,CAAC;IAED,IAAI,QAAQ,CAAC,gBAAgB,EAAE,MAAM,EAAE,CAAC;QACtC,MAAM,IAAI,iBAAiB,QAAQ,CAAC,gBAAgB,CAAC,MAAM,aAAa,CAAC;IAC3E,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/esm/tools/search.d.ts

@@ -3,44 +3,12 @@
  *
  * MCP tool for semantic search across user context.
  */
+import { Tool } from "@modelcontextprotocol/sdk/types.js";
 import { Attrove } from "@attrove/sdk";
 /**
  * Tool definition for attrove_search.
  */
-export declare const searchToolDefinition: {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: "object";
-        properties: {
-            query: {
-                type: string;
-                description: string;
-            };
-            after_date: {
-                type: string;
-                description: string;
-            };
-            before_date: {
-                type: string;
-                description: string;
-            };
-            sender_domains: {
-                type: string;
-                items: {
-                    type: string;
-                };
-                description: string;
-            };
-            include_body_text: {
-                type: string;
-                description: string;
-                default: boolean;
-            };
-        };
-        required: string[];
-    };
-};
+export declare const searchToolDefinition: Tool;
 /**
  * Input for the search tool.
  */
@@ -52,7 +20,7 @@ export interface SearchToolInput {
     include_body_text?: boolean;
 }
 /**
- * Execute the search tool.
+ * Search user messages via the SDK and format results grouped by conversation.
  */
 export declare function executeSearchTool(client: Attrove, input: SearchToolInput): Promise<string>;
 //# sourceMappingURL=search.d.ts.map

package/esm/tools/search.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../../../packages/mcp/src/tools/search.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,OAAO,EAIR,MAAM,cAAc,CAAC;AAGtB;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4ChC,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,OAAO,EACf,KAAK,EAAE,eAAe,GACrB,OAAO,CAAC,MAAM,CAAC,CA+GjB"}
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../../../packages/mcp/src/tools/search.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC1D,OAAO,EACL,OAAO,EAIR,MAAM,cAAc,CAAC;AAGtB;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,IAqDlC,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,OAAO,EACf,KAAK,EAAE,eAAe,GACrB,OAAO,CAAC,MAAM,CAAC,CAqHjB"}

package/esm/tools/search.js

@@ -9,10 +9,10 @@ import { MAX_BODY_PREVIEW_LENGTH } from "../constants.js";
  */
 export const searchToolDefinition = {
     name: "attrove_search",
-    description: `Search for specific messages or conversations in the user's communications.
+    description: `Search for messages or conversations in the user's own connected accounts.
 
-This tool performs semantic search across connected integrations and returns matching messages grouped by conversation. Use this when you need:
-- Raw message data without AI summarization
+This read-only tool performs semantic search across the authenticated user's connected services and returns matching messages grouped by conversation. Only the user's own authorized data is searched. Use this when you need:
+- Message data without AI summarization
 - To find specific conversations or threads
 - To explore what information is available about a topic
 
@@ -42,15 +42,23 @@ Use this tool when the user asks things like:
             },
             include_body_text: {
                 type: "boolean",
-                description: "Optional: Include full message body text",
+                // NOTE: The "200 characters" must match MAX_BODY_PREVIEW_LENGTH in constants.ts
+                description: "Optional: Include message body text preview (truncated to 200 characters)",
                 default: true,
             },
         },
         required: ["query"],
     },
+    annotations: {
+        title: "Search Messages",
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: true,
+    },
 };
 /**
- * Execute the search tool.
+ * Search user messages via the SDK and format results grouped by conversation.
  */
 export async function executeSearchTool(client, input) {
     const options = {
@@ -82,17 +90,21 @@ export async function executeSearchTool(client, input) {
     let skippedThreads = 0;
     let skippedMessages = 0;
     for (const [convId, conv] of Object.entries(response.conversations)) {
-        // Skip malformed conversation entries
+        // Skip malformed conversation entries - may occur with API version mismatches or partial responses
         if (!conv || !conv.threads) {
             skippedConversations++;
+            // prettier-ignore
+            console.error("[AttroveMCP]", JSON.stringify({ level: "warn", msg: "Search skipped malformed conversation", errorId: "MCP_SEARCH_MALFORMED_CONVERSATION", conversationId: convId, hasConv: !!conv, hasThreads: !!(conv?.threads) }));
             continue;
         }
         const convName = conv.conversation_name || `Conversation ${convId}`;
         result += `\n## ${convName}\n`;
         for (const [threadId, messages] of Object.entries(conv.threads)) {
-            // Skip malformed thread entries
+            // Skip malformed thread entries - may occur with API version mismatches or partial responses
             if (!Array.isArray(messages)) {
                 skippedThreads++;
+                // prettier-ignore
+                console.error("[AttroveMCP]", JSON.stringify({ level: "warn", msg: "Search skipped malformed thread", errorId: "MCP_SEARCH_MALFORMED_THREAD", conversationId: convId, threadId, messagesType: typeof messages }));
                 continue;
             }
             if (messages.length > 1) {
@@ -101,6 +113,8 @@ export async function executeSearchTool(client, input) {
             for (const msg of messages) {
                 if (!msg) {
                     skippedMessages++;
+                    // prettier-ignore
+                    console.error("[AttroveMCP]", JSON.stringify({ level: "warn", msg: "Search skipped null message", errorId: "MCP_SEARCH_NULL_MESSAGE", conversationId: convId, threadId }));
                     continue;
                 }
                 // Defensive date formatting to handle invalid dates gracefully

package/esm/tools/search.js.map

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

package/esm/transport/http.d.ts

@@ -0,0 +1,63 @@
+/**
+ * HTTP Transport for Attrove MCP Server
+ *
+ * Provides HTTP-based transport for the MCP server, enabling AI assistants
+ * like ChatGPT to connect via HTTP endpoints instead of stdio.
+ */
+/// <reference types="node" />
+import { IncomingMessage, ServerResponse } from "node:http";
+import { McpServerConfig } from "../server.js";
+/**
+ * Result when MCP request was successfully processed by the transport.
+ * Note: This indicates the transport handled the request, not that the MCP operation succeeded.
+ */
+interface McpHttpHandlerSuccess {
+    handled: true;
+    /** True if server cleanup failed after handling the request (potential resource leak) */
+    cleanupFailed?: boolean;
+}
+/**
+ * Result when MCP request could not be processed.
+ * When this is returned, no HTTP response has been sent - the caller must
+ * send an appropriate error response to the client.
+ */
+interface McpHttpHandlerFailure {
+    handled: false;
+    error: string;
+    /** Full stack trace if available, for logging */
+    stack?: string;
+    /** True if the failure was due to timeout */
+    isTimeout: boolean;
+}
+/**
+ * Discriminated union for MCP HTTP handler results.
+ * Use `result.handled` to narrow the type.
+ */
+export type McpHttpHandlerResult = McpHttpHandlerSuccess | McpHttpHandlerFailure;
+export type { McpHttpHandlerFailure };
+/**
+ * Configuration options for the HTTP handler.
+ */
+export interface CreateHttpHandlerOptions {
+    /**
+     * Enable JSON response mode instead of SSE streaming.
+     * When true, responses are returned as JSON objects.
+     * When false, responses use Server-Sent Events streaming.
+     * @default true
+     */
+    enableJsonResponse?: boolean;
+    /**
+     * Request timeout in milliseconds.
+     * Prevents requests from hanging indefinitely if MCP tools make slow external calls.
+     * @default 30000 (30 seconds)
+     */
+    timeoutMs?: number;
+}
+export declare function createHttpHandler(config: McpServerConfig, options?: CreateHttpHandlerOptions): McpHttpHandler;
+/**
+ * HTTP handler interface for processing MCP requests.
+ */
+export interface McpHttpHandler {
+    handleRequest: (req: IncomingMessage, res: ServerResponse, parsedBody?: unknown) => Promise<McpHttpHandlerResult>;
+}
+//# sourceMappingURL=http.d.ts.map

package/esm/transport/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../../../packages/mcp/src/transport/http.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;;AAEH,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAG5D,OAAO,EAAgB,eAAe,EAAE,MAAM,cAAc,CAAC;AAE7D;;;GAGG;AACH,UAAU,qBAAqB;IAC7B,OAAO,EAAE,IAAI,CAAC;IACd,yFAAyF;IACzF,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;;;GAIG;AACH,UAAU,qBAAqB;IAC7B,OAAO,EAAE,KAAK,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAC5B,qBAAqB,GACrB,qBAAqB,CAAC;AAG1B,YAAY,EAAE,qBAAqB,EAAE,CAAC;AAEtC;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAE7B;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAqCD,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,eAAe,EACvB,OAAO,GAAE,wBAA6B,GACrC,cAAc,CAsKhB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,CACb,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,UAAU,CAAC,EAAE,OAAO,KACjB,OAAO,CAAC,oBAAoB,CAAC,CAAC;CACpC"}