@theronap/cortex-mcp 0.9.93 → 0.9.94

package/lib/server.mjs

@@ -916,6 +916,40 @@ export async function runServer(version) {
     },
   )
 
+  server.registerTool(
+    'search_spam_email',
+    {
+      title: 'Search Gmail Spam intentionally',
+      description: 'Search a connected Gmail Spam folder only when the user explicitly asks you to find a message that may have been marked as Spam. This is read-only: results are returned for this request only and are NOT added to Agnoclast records, timeline, or future context. Give a specific Gmail search such as a sender, subject words, or date. Normal Gmail sync never reads Spam.',
+      inputSchema: {
+        query: z.string().min(2).describe('specific Gmail search within Spam, e.g. `from:billing@example.com`, `subject:(appointment reminder)`, or `after:2026/08/01`'),
+        account: z.string().email().optional().describe('which connected Gmail account to search when more than one is available'),
+        limit: z.number().int().min(1).max(10).optional().describe('maximum matches to return (default 5; max 10)'),
+      },
+    },
+    async ({ query, account, limit }) => {
+      const res = await fetchCortex(`${BASE}/api/gmail/search-spam`, {
+        method: 'POST',
+        headers: { Authorization: `Bearer ${TOKEN}`, 'Content-Type': 'application/json' },
+        body: JSON.stringify({ query, ...(account ? { account } : {}), ...(limit ? { limit } : {}) }),
+      })
+      const body = await res.json().catch(() => null)
+      if (!res.ok) {
+        if (res.status === 409 && Array.isArray(body?.accounts)) {
+          return toolError(`Choose a connected Gmail account and call again with account: ${body.accounts.join(', ')}`)
+        }
+        return toolError(body?.error ?? `Spam search failed (${res.status}).`)
+      }
+      const rows = Array.isArray(body?.messages) ? body.messages : []
+      if (!rows.length) return { content: [{ type: 'text', text: `No Spam matches in ${body?.account ?? 'the connected Gmail account'}. Nothing was saved to Agnoclast.` }] }
+      const lines = [`Spam matches in ${body.account} (read-only; not saved to Agnoclast):`]
+      for (const m of rows) {
+        lines.push(`- ${m.date || 'unknown date'} · ${m.from || 'unknown sender'} · ${m.subject}\n  ${m.snippet || '(no preview)'}\n  ${m.sourceUri}`)
+      }
+      return { content: [{ type: 'text', text: lines.join('\n') }] }
+    },
+  )
+
   server.registerTool(
     'grep',
     {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theronap/cortex-mcp",
-  "version": "0.9.93",
+  "version": "0.9.94",
   "description": "Connect your AI assistant to Cortex — your org's projects, activity, gaps, and directives, scoped to you.",
   "type": "module",
   "bin": {