@remit/mcp-server 0.13.0 → 0.14.0

package/dist/deps.d.ts

@@ -1,6 +1,6 @@
 import type { RemitClient } from "@remit/backend/client";
 import type { IAccountRepository, IAccountSettingRepository, IAddressRepository, IFilterRepository, ILabelMailboxRepository, ILabelRepository, IMailboxRepository, IMailboxSpecialUseRepository, IMessageLabelRepository, IMessageRepository, IOrganizeJobRequestRepository, IThreadMessageRepository, OrganizeJobEvent, QueueProducer } from "@remit/data-ports";
-import type { BodyPartMaterializer, BodySyncCue, MailboxQueueService, MaterializeLogger, MessageMoveService, OrganizeJobLogger } from "@remit/mailbox-service";
+import type { BodyPartMaterializer, BodySyncCue, MailboxQueueService, MaterializeLogger, MessageMoveService, OrganizeJobLogger, RescanService } from "@remit/mailbox-service";
 import type { StorageService } from "@remit/storage-service";
 export declare const FOLDER_SETTLE_TIMEOUT_MS = 20000;
 export declare const FOLDER_POLL_INTERVAL_MS = 500;
@@ -31,6 +31,7 @@ export interface McpDeps {
     storage: Pick<StorageService, "retrieveBodyPart">;
     bodySync: BodyPartMaterializer;
     bodySyncQueue: BodySyncCue;
+    rescan: Pick<RescanService, "rescan">;
     logger: MaterializeLogger;
     folders: FolderToolDeps;
     filters: FilterToolDeps;

package/dist/deps.js

@@ -17,6 +17,7 @@ export const mcpDepsOf = (client, { logger, settle }) => ({
     storage: client.storage,
     bodySync: client.bodySync,
     bodySyncQueue: client.bodySyncQueue,
+    rescan: client.rescan,
     logger,
     folders: { mailboxQueue: client.mailboxQueue, ...settle },
     filters: { organizeQueue: client.queues.accountFanout, logger },

package/dist/rescan-tools.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { McpDeps } from "./deps.js";
+export declare const registerRescanTools: (server: McpServer, deps: McpDeps, accountConfigId: string) => void;

package/dist/rescan-tools.js

@@ -0,0 +1,39 @@
+import { ownedAccount, RESCAN_LIMIT } from "@remit/mailbox-service";
+import { z } from "zod";
+import { asJson, notFoundRefusal, refused } from "./tool-result.js";
+const RESCAN_WRITE = {
+    readOnlyHint: false,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: true,
+};
+const notFound = notFoundRefusal("Use an accountId from list_mailboxes.");
+export const registerRescanTools = (server, deps, accountConfigId) => {
+    server.registerTool("rescan_messages", {
+        description: `Check up to ${RESCAN_LIMIT} messages of one account again with the category classifier and the spam check, and return each verdict. Sets a category only on uncategorized mail and never labels a message the owner marked Not spam. Moves nothing unless move is true. Each message lands in successful or failed; retry only the failed ids marked retryable. To rescan a folder, page through list_threads or search_threads and send ${RESCAN_LIMIT} ids per call.`,
+        inputSchema: {
+            accountId: z
+                .string()
+                .min(1)
+                .describe("The account the messages belong to, from list_mailboxes"),
+            messageIds: z
+                .array(z.string().min(1))
+                .min(1)
+                .max(RESCAN_LIMIT)
+                .describe("Messages from list_threads, search_threads or get_thread"),
+            move: z
+                .boolean()
+                .default(false)
+                .describe("Also move a message the verdict sends to Junk"),
+        },
+        annotations: RESCAN_WRITE,
+    }, async ({ accountId, messageIds, move }) => {
+        const owned = await deps.account
+            .get(accountId)
+            .then((account) => ownedAccount(account, accountConfigId, "act"))
+            .catch(notFound);
+        if (!owned.ok)
+            return refused(owned.refusal);
+        return asJson(await deps.rescan.rescan({ accountId, accountConfigId }, { messageIds, move }));
+    });
+};

package/dist/server.js

@@ -7,6 +7,7 @@ import { registerFolderTools } from "./folder-tools.js";
 import { registerLabelReadTools, registerLabelWriteTools, } from "./label-tools.js";
 import { registerMoveTools } from "./move-tools.js";
 import { registerReadTools } from "./read-tools.js";
+import { registerRescanTools } from "./rescan-tools.js";
 const unusedJsonSchemaValidator = {
     getValidator: () => {
         throw new Error("JSON Schema validation is unused by this server: tools validate input with zod and declare no output schema");
@@ -23,6 +24,7 @@ const buildServer = (principal, deps) => {
         registerLabelWriteTools(server, deps, deriveAccountConfigId(principal.userId));
         registerFilterTools(server, deps, principal.userId);
         registerMoveTools(server, deps, principal.userId);
+        registerRescanTools(server, deps, deriveAccountConfigId(principal.userId));
     }
     return server;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@remit/mcp-server",
-	"version": "0.13.0",
+	"version": "0.14.0",
 	"description": "The remit MCP server: mail tools over streamable HTTP and the OAuth authorization server that guards them.",
 	"type": "module",
 	"exports": {
@@ -25,12 +25,12 @@
 		"@better-auth/oauth-provider": "^1.7.12",
 		"@hono/node-server": "^2.1.3",
 		"@modelcontextprotocol/sdk": "1.32.1",
-		"@remit/auth-service": "0.3.12",
-		"@remit/data-ports": "2.9.0",
-		"@remit/domain-enums": "0.0.54",
-		"@remit/drizzle-service": "3.7.0",
-		"@remit/mailbox-service": "2.22.0",
-		"@remit/storage-service": "0.0.40",
+		"@remit/auth-service": "0.3.14",
+		"@remit/data-ports": "2.11.0",
+		"@remit/domain-enums": "0.0.56",
+		"@remit/drizzle-service": "3.7.2",
+		"@remit/mailbox-service": "2.24.0",
+		"@remit/storage-service": "0.0.42",
 		"@remit/ui": "0.0.234",
 		"better-auth": "^1.7.12",
 		"drizzle-orm": "1.0.0-rc.5",
@@ -38,12 +38,12 @@
 		"react": "^19",
 		"react-dom": "^19",
 		"zod": "^4.6.7",
-		"@remit/backend": "5.8.0",
+		"@remit/backend": "5.10.0",
 		"@types/react": "^19",
 		"@types/react-dom": "^19"
 	},
 	"devDependencies": {
-		"@remit/imap-worker": "3.4.0",
+		"@remit/imap-worker": "3.5.1",
 		"@tailwindcss/vite": "^4",
 		"tailwindcss": "^4",
 		"tsx": "*",