@migma/mcp 1.1.2 → 1.3.1

package/build/tools/generate.js

@@ -1,115 +1,223 @@
 import { z } from "zod";
-export function registerGenerateTools(server, client, config) {
-    server.registerTool("migma_generate_email", {
-        title: "Generate Email",
-        description: "Generate one email or a series from a text prompt. Uses the project's brand identity and returns finished HTML, subject lines, email IDs, and screenshots when complete.",
-        inputSchema: z.object({
-            projectId: z
-                .string()
-                .optional()
-                .describe("Project/brand ID. Local stdio uses MIGMA_PROJECT_ID if not provided; hosted remote clients should pass projectId."),
-            prompt: z.string().min(1).describe("Email generation prompt"),
-            languages: z
-                .array(z.string())
-                .max(5)
-                .optional()
-                .describe("Languages (e.g. ['en', 'fr']). Default: ['en']"),
-            count: z
-                .number()
-                .int()
-                .min(1)
-                .max(12)
-                .optional()
-                .describe("Target email count for a series. Omit to infer from prompt."),
-        }),
-    }, async (args) => {
-        const projectId = args.projectId || config.projectId;
-        if (!projectId) {
-            return toolError("projectId is required. Provide projectId, or set MIGMA_PROJECT_ID when using local stdio.");
-        }
-        const { data, error } = await client.emails.generateAndWait({
-            projectId,
-            prompt: args.prompt,
-            languages: args.languages,
-            count: args.count,
+import { canUse } from "../permissions.js";
+export function registerGenerateTools(server, client, config, grantedPermissions) {
+    if (canUse(grantedPermissions, ["email:write", "email:read"])) {
+        server.registerTool("migma_generate_email", {
+            title: "Generate Email",
+            description: "Start generating one email or a series from a prompt. Returns conversationId immediately — generation keeps running in the background. Poll migma_get_generation_status with that id until status is completed or failed. Do not use migma_get_project or migma_list_campaigns to check progress. Charges 1 email credit per finished email.",
+            inputSchema: z.object({
+                projectId: z
+                    .string()
+                    .optional()
+                    .describe("Project/brand ID. Local stdio uses MIGMA_PROJECT_ID if not provided; hosted remote clients should pass projectId."),
+                prompt: z.string().min(1).describe("Email generation prompt"),
+                languages: z
+                    .array(z.string())
+                    .max(5)
+                    .optional()
+                    .describe("Languages (e.g. ['en', 'fr']). Default: ['en']"),
+                count: z
+                    .number()
+                    .int()
+                    .min(1)
+                    .max(12)
+                    .optional()
+                    .describe("Target email count for a series. Omit to infer from prompt."),
+            }),
+        }, async (args) => {
+            const projectId = args.projectId || config.projectId;
+            if (!projectId) {
+                return toolError("projectId is required. Provide projectId, or set MIGMA_PROJECT_ID when using local stdio.");
+            }
+            const { data, error } = await client.emails.generate({
+                projectId,
+                prompt: args.prompt,
+                languages: args.languages,
+                count: args.count,
+            });
+            if (error)
+                return toolError(error.message);
+            return toolResult(data);
         });
-        if (error)
-            return toolError(error.message);
-        return toolResult(data);
-    });
-    server.registerTool("migma_get_generation_status", {
-        title: "Get Generation Status",
-        description: "Check the status of an email generation. When complete, result.emails[] contains each generated email's emailId, HTML, subject, and screenshot URLs.",
-        inputSchema: z.object({
-            conversationId: z.string().describe("The conversation/generation ID"),
-        }),
-    }, async (args) => {
-        const { data, error } = await client.emails.getGenerationStatus(args.conversationId);
-        if (error)
-            return toolError(error.message);
-        return toolResult(data);
-    });
-    server.registerTool("migma_send_test_email", {
-        title: "Send Test Email",
-        description: "Send a test email for a generated email ID or a single-email conversation.",
-        inputSchema: z.object({
-            emailId: z
-                .string()
-                .optional()
-                .describe("Generated email ID from result.emails[].emailId"),
-            conversationId: z
-                .string()
-                .optional()
-                .describe("Conversation ID. Works when the conversation contains a single email."),
-            to: z.string().email().describe("Recipient email address"),
-        }),
-    }, async (args) => {
-        if (!args.emailId && !args.conversationId) {
-            return toolError("emailId or conversationId is required.");
-        }
-        const sendTestParams = {
-            emailId: args.emailId,
-            conversationId: args.conversationId,
-            to: args.to,
-        };
-        const { data, error } = await client.emails.sendTest(sendTestParams);
-        if (error)
-            return toolError(error.message);
-        return toolResult(data);
-    });
-    server.registerTool("migma_get_email", {
-        title: "Get Email",
-        description: "Fetch one generated email by emailId. Returns email-safe HTML, subject, screenshot URLs, and metadata.",
-        inputSchema: z.object({
-            emailId: z.string().describe("Generated email ID from result.emails[].emailId"),
-        }),
-    }, async (args) => {
-        const { data, error } = await client.emails.get(args.emailId);
-        if (error)
-            return toolError(error.message);
-        return toolResult(data);
-    });
-    server.registerTool("migma_edit_email", {
-        title: "Edit Email",
-        description: "Edit one generated email with a natural-language prompt. Returns the updated HTML, subject, screenshot URLs, and metadata.",
-        inputSchema: z.object({
-            emailId: z.string().describe("Generated email ID from result.emails[].emailId"),
-            prompt: z
-                .string()
-                .min(1)
-                .describe("Edit instruction, e.g. 'Make the welcome email shorter and more transactional.'"),
-            label: z.string().optional().describe("Optional version label for this edit."),
-        }),
-    }, async (args) => {
-        const emails = client.emails;
-        const { data, error } = await emails.edit(args.emailId, {
-            prompt: args.prompt,
-            label: args.label,
+    }
+    if (canUse(grantedPermissions, ["email:read"])) {
+        server.registerTool("migma_get_generation_status", {
+            title: "Get Generation Status",
+            description: "Poll a generation started by migma_generate_email. Pass conversationId. Status is pending, processing, completed, or failed. When completed, result.emails[] has emailId, HTML, subject, and screenshots. This is how you check email design progress — not campaigns.",
+            annotations: { readOnlyHint: true },
+            inputSchema: z.object({
+                conversationId: z.string().describe("The conversation/generation ID"),
+            }),
+        }, async (args) => {
+            const { data, error } = await client.emails.getGenerationStatus(args.conversationId);
+            if (error)
+                return toolError(error.message);
+            return toolResult(data);
         });
-        if (error)
-            return toolError(error.message);
-        return toolResult(data);
-    });
+    }
+    if (canUse(grantedPermissions, ["email:send"])) {
+        server.registerTool("migma_send_test_email", {
+            title: "Send Test Email",
+            description: "Send a test email for a generated email ID or a single-email conversation.",
+            inputSchema: z.object({
+                emailId: z
+                    .string()
+                    .optional()
+                    .describe("Generated email ID from result.emails[].emailId"),
+                conversationId: z
+                    .string()
+                    .optional()
+                    .describe("Conversation ID. Works when the conversation contains a single email."),
+                to: z.string().email().describe("Recipient email address"),
+            }),
+        }, async (args) => {
+            if (!args.emailId && !args.conversationId) {
+                return toolError("emailId or conversationId is required.");
+            }
+            const sendTestParams = {
+                emailId: args.emailId,
+                conversationId: args.conversationId,
+                to: args.to,
+            };
+            const { data, error } = await client.emails.sendTest(sendTestParams);
+            if (error)
+                return toolError(error.message);
+            return toolResult(data);
+        });
+    }
+    if (canUse(grantedPermissions, ["email:read"])) {
+        server.registerTool("migma_list_emails", {
+            title: "List Emails",
+            description: "List generated email designs for a project (drafts in the canvas). Returns conversationId, title, subject, status (pending/processing/completed/failed), and screenshot. Use this to answer 'what emails do we have?'. Not campaigns — those are audience sends via migma_list_campaigns. Ignore project.templateCount.",
+            annotations: { readOnlyHint: true },
+            inputSchema: z.object({
+                projectId: z
+                    .string()
+                    .optional()
+                    .describe("Project/brand ID. Local stdio uses MIGMA_PROJECT_ID if not provided; hosted remote clients should pass projectId."),
+                limit: z
+                    .number()
+                    .int()
+                    .min(1)
+                    .max(100)
+                    .optional()
+                    .describe("Max results (default 20)"),
+                page: z
+                    .number()
+                    .int()
+                    .min(1)
+                    .optional()
+                    .describe("Page number (default 1)"),
+                status: z
+                    .enum(["pending", "processing", "completed", "failed"])
+                    .optional()
+                    .describe("Filter by generation status"),
+                search: z.string().optional().describe("Search title or subject"),
+            }),
+        }, async (args) => {
+            const projectId = args.projectId || config.projectId;
+            if (!projectId) {
+                return toolError("projectId is required. Provide projectId, or set MIGMA_PROJECT_ID when using local stdio.");
+            }
+            const { data, error } = await client.emails.list({
+                projectId,
+                limit: args.limit,
+                page: args.page,
+                status: args.status,
+                search: args.search,
+            });
+            if (error)
+                return toolError(error.message);
+            return toolResult(data);
+        });
+    }
+    if (canUse(grantedPermissions, ["email:read"])) {
+        server.registerTool("migma_get_email", {
+            title: "Get Email",
+            description: "Fetch one generated email by emailId. Returns email-safe HTML, subject, screenshot URLs, variable requirements, and metadata.",
+            annotations: { readOnlyHint: true },
+            inputSchema: z.object({
+                emailId: z.string().describe("Generated email ID from result.emails[].emailId"),
+            }),
+        }, async (args) => {
+            const { data, error } = await client.emails.get(args.emailId);
+            if (error)
+                return toolError(error.message);
+            return toolResult(data);
+        });
+    }
+    if (canUse(grantedPermissions, ["email:write"])) {
+        server.registerTool("migma_edit_email", {
+            title: "Edit Email",
+            description: "Edit one generated email with a natural-language prompt. Returns the updated HTML, subject, screenshot URLs, and metadata. Charges 0.5 email credit, the same as an edit in the dashboard, taken only after the edit persists.",
+            inputSchema: z.object({
+                emailId: z.string().describe("Generated email ID from result.emails[].emailId"),
+                prompt: z
+                    .string()
+                    .min(1)
+                    .describe("Edit instruction, e.g. 'Make the welcome email shorter and more transactional.'"),
+                label: z.string().optional().describe("Optional version label for this edit."),
+            }),
+        }, async (args) => {
+            const emails = client.emails;
+            const { data, error } = await emails.edit(args.emailId, {
+                prompt: args.prompt,
+                label: args.label,
+            });
+            if (error)
+                return toolError(error.message);
+            return toolResult(data);
+        });
+    }
+    if (canUse(grantedPermissions, ["email:read"])) {
+        server.registerTool("migma_get_email_metrics", {
+            title: "Get Email Metrics",
+            description: "Aggregate performance for one generated email across every API send of it: summary (totalEmails, delivered, opened, clicked, bounced, complained, unsubscribed, plus 0-100 rates), a daily timeSeries, and countryBreakdown. Sourced from the tracking worker (may be slightly stale, ~30-day raw window). Opens are directional — Apple Mail Privacy Protection and bots inflate them; clicks and delivery events are stronger signals.",
+            annotations: { readOnlyHint: true },
+            inputSchema: z.object({
+                emailId: z.string().describe("Generated email ID from result.emails[].emailId"),
+            }),
+        }, async (args) => {
+            const { data, error } = await client.emails.metrics(args.emailId);
+            if (error)
+                return toolError(error.message);
+            return toolResult(data);
+        });
+    }
+    if (canUse(grantedPermissions, ["email:read"])) {
+        server.registerTool("migma_get_email_logs", {
+            title: "Get Email Logs",
+            description: "Per-recipient send log for one generated email, cursor-paginated. Each row comes from the tracking worker's D1 table (snake_case): to_email, from_email, subject, status, opened_at, clicked_at, open_count, click_count, bounce_type, complaint_type, created_at. Returns { emails, nextCursor, hasMore }.",
+            annotations: { readOnlyHint: true },
+            inputSchema: z.object({
+                emailId: z.string().describe("Generated email ID from result.emails[].emailId"),
+                limit: z
+                    .number()
+                    .int()
+                    .min(1)
+                    .max(100)
+                    .optional()
+                    .describe("Max rows per page (default 20, capped at 100)"),
+                cursor: z
+                    .string()
+                    .optional()
+                    .describe("Pagination cursor from a previous response's nextCursor"),
+                status: z
+                    .enum(["delivered", "opened", "clicked", "bounced", "complained", "suppressed", "sent"])
+                    .optional()
+                    .describe("Filter rows by delivery/engagement status"),
+            }),
+        }, async (args) => {
+            const { data, error } = await client.emails.logs(args.emailId, {
+                limit: args.limit,
+                cursor: args.cursor,
+                status: args.status,
+            });
+            if (error)
+                return toolError(error.message);
+            return toolResult(data);
+        });
+    }
 }
 function toolResult(data) {
     return {

package/build/tools/generate.js.map

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

package/build/tools/metrics.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { Migma } from "migma";
+export declare function registerMetricsTools(server: McpServer, client: Migma, grantedPermissions?: string[]): void;
+//# sourceMappingURL=metrics.d.ts.map

package/build/tools/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../src/tools/metrics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAInC,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,KAAK,EACb,kBAAkB,CAAC,EAAE,MAAM,EAAE,QA2B9B"}

package/build/tools/metrics.js

@@ -0,0 +1,39 @@
+import { z } from "zod";
+import { canUse } from "../permissions.js";
+export function registerMetricsTools(server, client, grantedPermissions) {
+    if (canUse(grantedPermissions, ["email:read"])) {
+        server.registerTool("migma_get_sending_metrics", {
+            title: "Get Sending Metrics",
+            description: "Get account sending usage, delivery outcomes, daily and monthly limits, remaining capacity, and optional monthly history.",
+            annotations: { readOnlyHint: true },
+            inputSchema: z.object({
+                months: z
+                    .number()
+                    .int()
+                    .min(1)
+                    .max(12)
+                    .optional()
+                    .describe("Number of monthly history periods to include (1-12)"),
+            }),
+        }, async (args) => {
+            const { data, error } = await client.metrics.sending({ months: args.months });
+            if (error)
+                return toolError(error.message);
+            return toolResult(data);
+        });
+    }
+}
+function toolResult(data) {
+    return {
+        content: [
+            { type: "text", text: JSON.stringify(data, null, 2) },
+        ],
+    };
+}
+function toolError(message) {
+    return {
+        content: [{ type: "text", text: message }],
+        isError: true,
+    };
+}
+//# sourceMappingURL=metrics.js.map

package/build/tools/metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../../src/tools/metrics.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C,MAAM,UAAU,oBAAoB,CAClC,MAAiB,EACjB,MAAa,EACb,kBAA6B;IAE7B,IAAI,MAAM,CAAC,kBAAkB,EAAE,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC;QAC/C,MAAM,CAAC,YAAY,CACjB,2BAA2B,EAC3B;YACE,KAAK,EAAE,qBAAqB;YAC5B,WAAW,EACT,2HAA2H;YAC7H,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;YACnC,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;gBACpB,MAAM,EAAE,CAAC;qBACN,MAAM,EAAE;qBACR,GAAG,EAAE;qBACL,GAAG,CAAC,CAAC,CAAC;qBACN,GAAG,CAAC,EAAE,CAAC;qBACP,QAAQ,EAAE;qBACV,QAAQ,CAAC,qDAAqD,CAAC;aACnE,CAAC;SACH,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;YACb,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;YAC9E,IAAI,KAAK;gBAAE,OAAO,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAC3C,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC,CACF,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CAAC,IAAa;IAC/B,OAAO;QACL,OAAO,EAAE;YACP,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE;SAC/D;KACF,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,OAAe;IAChC,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;QACnD,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC"}

package/build/tools/projects.d.ts

@@ -1,5 +1,5 @@
 import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import type { Migma } from "migma";
 import type { Config } from "../config.js";
-export declare function registerProjectTools(server: McpServer, client: Migma, config: Config): void;
+export declare function registerProjectTools(server: McpServer, client: Migma, config: Config, grantedPermissions?: string[]): void;
 //# sourceMappingURL=projects.d.ts.map

package/build/tools/projects.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../../src/tools/projects.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAEnC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAS3C,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,KAAK,EACb,MAAM,EAAE,MAAM,QAsGf"}
+{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../../src/tools/projects.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAEnC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAU3C,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,KAAK,EACb,MAAM,EAAE,MAAM,EACd,kBAAkB,CAAC,EAAE,MAAM,EAAE,QAiH9B"}

package/build/tools/projects.js

@@ -1,83 +1,101 @@
 import { z } from "zod";
-export function registerProjectTools(server, client, config) {
-    server.registerTool("migma_list_projects", {
-        title: "List Projects",
-        description: "List all Migma projects (brands). Returns project IDs, names, domains, and statuses.",
-        inputSchema: z.object({
-            limit: z
-                .number()
-                .int()
-                .min(1)
-                .max(100)
-                .optional()
-                .describe("Max results (default 20)"),
-            offset: z
-                .number()
-                .int()
-                .min(0)
-                .optional()
-                .describe("Pagination offset"),
-        }),
-    }, async (args) => {
-        const { data, error } = await client.projects.list({
-            limit: args.limit,
-            offset: args.offset,
+import { canUse } from "../permissions.js";
+export function registerProjectTools(server, client, config, grantedPermissions) {
+    if (canUse(grantedPermissions, ["email:read"])) {
+        server.registerTool("migma_list_projects", {
+            title: "List Projects",
+            description: "List all Migma projects (brands). Returns project IDs, names, domains, and statuses.",
+            annotations: { readOnlyHint: true },
+            inputSchema: z.object({
+                limit: z
+                    .number()
+                    .int()
+                    .min(1)
+                    .max(100)
+                    .optional()
+                    .describe("Max results (default 20)"),
+                offset: z
+                    .number()
+                    .int()
+                    .min(0)
+                    .optional()
+                    .describe("Pagination offset"),
+            }),
+        }, async (args) => {
+            const { data, error } = await client.projects.list({
+                limit: args.limit,
+                offset: args.offset,
+            });
+            if (error)
+                return toolError(error.message);
+            return toolResult(data);
         });
-        if (error)
-            return toolError(error.message);
-        return toolResult(data);
-    });
-    server.registerTool("migma_get_project", {
-        title: "Get Project Details",
-        description: "Get detailed information about a Migma project/brand including colors, fonts, logos, and tone of voice.",
-        inputSchema: z.object({
-            projectId: z.string().describe("The project ID"),
-        }),
-    }, async (args) => {
-        const { data, error } = await client.projects.get(args.projectId);
-        if (error)
-            return toolError(error.message);
-        return toolResult(data);
-    });
-    server.registerTool("migma_import_brand", {
-        title: "Import Brand",
-        description: "Import a brand from one or more website URLs. Extracts colors, fonts, logos, and tone of voice. Polls until import completes.",
-        inputSchema: z.object({
-            urls: z
-                .array(z.string())
-                .min(1)
-                .max(10)
-                .describe("Website URLs to import brand from"),
-        }),
-    }, async (args) => {
-        const { data, error } = await client.projects.importAndWait({
-            urls: args.urls,
+    }
+    if (canUse(grantedPermissions, ["email:read"])) {
+        server.registerTool("migma_get_project", {
+            title: "Get Project Details",
+            description: "Get brand details for a project: colors, fonts, logos, voice, knowledge base. Not the email inventory — templateCount, templates, and emails on this payload are unused leftovers. To list designed emails use migma_list_emails. To list audience sends use migma_list_campaigns.",
+            annotations: { readOnlyHint: true },
+            inputSchema: z.object({
+                projectId: z.string().describe("The project ID"),
+            }),
+        }, async (args) => {
+            const { data, error } = await client.projects.get(args.projectId);
+            if (error)
+                return toolError(error.message);
+            return toolResult(stripStaleProjectInventory(data));
         });
-        if (error)
-            return toolError(error.message);
-        return toolResult(data);
-    });
-    server.registerTool("migma_get_field_catalog", {
-        title: "Get Project Field Catalog",
-        description: "Get the project's subscriber field catalog: which fields exist (e.g. firstName, company), how often each is populated (fillRate 0–1), example values, and whether the field is auto-filled at send time. Use this to discover available template variables before drafting an email. Optionally scope by segmentId or tag.",
-        inputSchema: z.object({
-            projectId: z.string().describe("The project ID"),
-            segmentId: z
-                .string()
-                .optional()
-                .describe("Restrict the catalog to subscribers in this segment"),
-            tag: z
-                .string()
-                .optional()
-                .describe("Restrict the catalog to subscribers with this tag id"),
-        }),
-    }, async (args) => {
-        const projects = client.projects;
-        const { data, error } = await projects.fieldCatalog(args.projectId, { segmentId: args.segmentId, tag: args.tag });
-        if (error)
-            return toolError(error.message);
-        return toolResult(data);
-    });
+    }
+    if (canUse(grantedPermissions, ["project:write", "email:read"])) {
+        server.registerTool("migma_import_brand", {
+            title: "Import Brand",
+            description: "Import a brand from one or more website URLs. Extracts colors, fonts, logos, and tone of voice. Polls until import completes.",
+            inputSchema: z.object({
+                urls: z
+                    .array(z.string())
+                    .min(1)
+                    .max(10)
+                    .describe("Website URLs to import brand from"),
+            }),
+        }, async (args) => {
+            const { data, error } = await client.projects.importAndWait({
+                urls: args.urls,
+            });
+            if (error)
+                return toolError(error.message);
+            return toolResult(data);
+        });
+    }
+    if (canUse(grantedPermissions, ["audience:read"])) {
+        server.registerTool("migma_get_field_catalog", {
+            title: "Get Project Field Catalog",
+            description: "Get the project's subscriber field catalog: which fields exist (e.g. firstName, company), how often each is populated (fillRate 0–1), example values, and whether the field is auto-filled at send time. Use this to discover available template variables before drafting an email. Optionally scope by segmentId or tag.",
+            annotations: { readOnlyHint: true },
+            inputSchema: z.object({
+                projectId: z.string().describe("The project ID"),
+                segmentId: z
+                    .string()
+                    .optional()
+                    .describe("Restrict the catalog to subscribers in this segment"),
+                tag: z
+                    .string()
+                    .optional()
+                    .describe("Restrict the catalog to subscribers with this tag id"),
+            }),
+        }, async (args) => {
+            const projects = client.projects;
+            const { data, error } = await projects.fieldCatalog(args.projectId, { segmentId: args.segmentId, tag: args.tag });
+            if (error)
+                return toolError(error.message);
+            return toolResult(data);
+        });
+    }
+}
+function stripStaleProjectInventory(data) {
+    if (!data || typeof data !== "object")
+        return data;
+    const { templateCount: _templateCount, templates: _templates, emails: _emails, ...brand } = data;
+    return brand;
 }
 function toolResult(data) {
     return {