mailtea-mcp 0.1.0

package/dist/chunk-NEG2GOMD.js

@@ -0,0 +1,4034 @@
+// src/index.ts
+var DEFAULT_API_BASE_URL = "https://api.mailtea.app";
+var MCP_TOOLS = [
+  {
+    name: "auth.me",
+    description: "Return auth identity for current token",
+    inputSchema: {
+      type: "object",
+      properties: {}
+    }
+  },
+  {
+    name: "issue.create_draft",
+    description: "Create a marketing email draft. Set kind to 'newsletter' (default) for recurring content that can publish to the public site, or 'broadcast' for a one-time email-only send (promotion, launch, announcement). Provide content one of three ways: templateId (seed from a published server template \u2014 use template.list/template.get to find one \u2014 with {{variables}} substituted), contentHtml (raw HTML), or contentSpec (json-render spec). Spec is recommended for AI agents \u2014 use components: Html, Head, Body, Container, Section, Row, Column, Heading, Text, Link, Button, Image, Hr, Preview, Markdown, MailteaHeader, MailteaFooter, MailteaSpacer, MailteaContentBlock.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        publicationId: { type: "string" },
+        title: { type: "string" },
+        kind: { type: "string", enum: ["newsletter", "broadcast"], description: "Email kind. 'newsletter' (default) can publish to the public site; 'broadcast' is one-time email-only." },
+        templateId: { type: "string", description: "Seed the draft from a published server template (see template.list). Takes precedence over contentHtml/contentSpec." },
+        variables: { type: "object", description: "Key/value map substituted into the template's {{variable}} placeholders when templateId is set." },
+        contentHtml: { type: "string", description: "Raw HTML content (use this OR contentSpec OR templateId)" },
+        contentSpec: {
+          type: "object",
+          description: "json-render spec (flat element map). Use this OR contentHtml OR templateId. Properties: root (string, element key), elements (record of {type, props?, children?})",
+          properties: {
+            root: { type: "string" },
+            elements: { type: "object" }
+          },
+          required: ["root", "elements"]
+        }
+      },
+      required: ["publicationId", "title"]
+    }
+  },
+  {
+    name: "issue.get_editor",
+    description: "Load issue editor payload for a draft or scheduled issue",
+    inputSchema: {
+      type: "object",
+      properties: {
+        issueId: { type: "string" }
+      },
+      required: ["issueId"]
+    }
+  },
+  {
+    name: "issue.update_draft",
+    description: "Update an existing draft issue. Provide contentHtml (raw HTML) or contentSpec (json-render spec).",
+    inputSchema: {
+      type: "object",
+      properties: {
+        issueId: { type: "string" },
+        title: { type: "string" },
+        contentHtml: { type: "string", description: "Raw HTML content (use this OR contentSpec)" },
+        contentSpec: {
+          type: "object",
+          description: "json-render spec (flat element map). Use this OR contentHtml.",
+          properties: {
+            root: { type: "string" },
+            elements: { type: "object" }
+          },
+          required: ["root", "elements"]
+        }
+      },
+      required: ["issueId", "title"]
+    }
+  },
+  {
+    name: "issue.remove_draft",
+    description: "Delete an existing draft issue",
+    inputSchema: {
+      type: "object",
+      properties: {
+        issueId: { type: "string" }
+      },
+      required: ["issueId"]
+    }
+  },
+  {
+    name: "issue.list_recent",
+    description: "List recent issues for a publication",
+    inputSchema: {
+      type: "object",
+      properties: {
+        publicationId: { type: "string" },
+        limit: { type: "number" }
+      },
+      required: ["publicationId"]
+    }
+  },
+  {
+    name: "publication.list",
+    description: "List publication workspaces available to current user/token",
+    inputSchema: {
+      type: "object",
+      properties: {}
+    }
+  },
+  {
+    name: "publication.create",
+    description: "Create a publication workspace and attach owner membership",
+    inputSchema: {
+      type: "object",
+      properties: {
+        publicationId: { type: "string" },
+        name: { type: "string" },
+        timezone: { type: "string" }
+      },
+      required: ["name"]
+    }
+  },
+  {
+    name: "publication.domain_list",
+    description: "List custom domains connected to a publication",
+    inputSchema: {
+      type: "object",
+      properties: {
+        publicationId: { type: "string" },
+        limit: { type: "number" }
+      },
+      required: ["publicationId"]
+    }
+  },
+  {
+    name: "publication.domain_upsert",
+    description: "Create or update a publication custom domain",
+    inputSchema: {
+      type: "object",
+      properties: {
+        publicationId: { type: "string" },
+        host: { type: "string" },
+        isPrimary: { type: "boolean" },
+        proxyTarget: { type: "string" }
+      },
+      required: ["publicationId", "host"]
+    }
+  },
+  {
+    name: "publication.domain_verify",
+    description: "Mark a publication domain as verified",
+    inputSchema: {
+      type: "object",
+      properties: {
+        publicationId: { type: "string" },
+        domainId: { type: "string" },
+        verificationValue: { type: "string" }
+      },
+      required: ["publicationId", "domainId"]
+    }
+  },
+  {
+    name: "publication.domain_set_primary",
+    description: "Set an existing publication domain as primary",
+    inputSchema: {
+      type: "object",
+      properties: {
+        publicationId: { type: "string" },
+        domainId: { type: "string" }
+      },
+      required: ["publicationId", "domainId"]
+    }
+  },
+  {
+    name: "publication.domain_remove",
+    description: "Remove a publication custom domain",
+    inputSchema: {
+      type: "object",
+      properties: {
+        publicationId: { type: "string" },
+        domainId: { type: "string" }
+      },
+      required: ["publicationId", "domainId"]
+    }
+  },
+  {
+    name: "publication.domain_traefik_preview",
+    description: "Generate Traefik dynamic-file preview for publication domains",
+    inputSchema: {
+      type: "object",
+      properties: {
+        publicationId: { type: "string" }
+      },
+      required: ["publicationId"]
+    }
+  },
+  {
+    name: "contact.list",
+    description: "List contacts for a publication",
+    inputSchema: {
+      type: "object",
+      properties: {
+        publicationId: { type: "string" },
+        status: {
+          type: "string",
+          enum: ["active", "unsubscribed", "suppressed"]
+        },
+        query: { type: "string" },
+        limit: { type: "number" }
+      },
+      required: ["publicationId"]
+    }
+  },
+  {
+    name: "contact.upsert",
+    description: "Create or reactivate a contact by email",
+    inputSchema: {
+      type: "object",
+      properties: {
+        publicationId: { type: "string" },
+        email: { type: "string" },
+        referrerContactId: { type: "string" }
+      },
+      required: ["publicationId", "email"]
+    }
+  },
+  {
+    name: "contact.set_status",
+    description: "Set contact status (active, unsubscribed, suppressed)",
+    inputSchema: {
+      type: "object",
+      properties: {
+        publicationId: { type: "string" },
+        contactId: { type: "string" },
+        status: {
+          type: "string",
+          enum: ["active", "unsubscribed", "suppressed"]
+        }
+      },
+      required: ["publicationId", "contactId", "status"]
+    }
+  },
+  {
+    name: "contact.import_csv",
+    description: "Import contacts from CSV text payload",
+    inputSchema: {
+      type: "object",
+      properties: {
+        publicationId: { type: "string" },
+        csvText: { type: "string" }
+      },
+      required: ["publicationId", "csvText"]
+    }
+  },
+  {
+    name: "contact.referral_summary",
+    description: "Load referral conversion leaderboard for a publication",
+    inputSchema: {
+      type: "object",
+      properties: {
+        publicationId: { type: "string" },
+        limit: { type: "number" }
+      },
+      required: ["publicationId"]
+    }
+  },
+  {
+    name: "contact.referral_milestones",
+    description: "List referral milestone rules for a publication",
+    inputSchema: {
+      type: "object",
+      properties: {
+        publicationId: { type: "string" },
+        limit: { type: "number" }
+      },
+      required: ["publicationId"]
+    }
+  },
+  {
+    name: "contact.referral_milestone_upsert",
+    description: "Create or update a referral milestone rule",
+    inputSchema: {
+      type: "object",
+      properties: {
+        publicationId: { type: "string" },
+        milestoneId: { type: "string" },
+        title: { type: "string" },
+        description: { type: "string" },
+        referralCount: { type: "number" }
+      },
+      required: ["publicationId", "title", "referralCount"]
+    }
+  },
+  {
+    name: "contact.referral_milestone_remove",
+    description: "Delete a referral milestone rule",
+    inputSchema: {
+      type: "object",
+      properties: {
+        publicationId: { type: "string" },
+        milestoneId: { type: "string" }
+      },
+      required: ["publicationId", "milestoneId"]
+    }
+  },
+  {
+    name: "contact.referral_rewards",
+    description: "List awarded referral rewards for a publication",
+    inputSchema: {
+      type: "object",
+      properties: {
+        publicationId: { type: "string" },
+        contactId: { type: "string" },
+        limit: { type: "number" }
+      },
+      required: ["publicationId"]
+    }
+  },
+  {
+    name: "monetize.offer_list",
+    description: "List sponsor offers for a publication",
+    inputSchema: {
+      type: "object",
+      properties: {
+        publicationId: { type: "string" },
+        status: {
+          type: "string",
+          enum: ["draft", "active", "paused", "archived"]
+        },
+        limit: { type: "number" }
+      },
+      required: ["publicationId"]
+    }
+  },
+  {
+    name: "monetize.offer_upsert",
+    description: "Create or update a sponsor offer",
+    inputSchema: {
+      type: "object",
+      properties: {
+        publicationId: { type: "string" },
+        offerId: { type: "string" },
+        title: { type: "string" },
+        sponsorName: { type: "string" },
+        description: { type: "string" },
+        pricingModel: {
+          type: "string",
+          enum: ["flat", "cpm"]
+        },
+        rateCents: { type: "number" },
+        estimatedPlacements: { type: "number" },
+        status: {
+          type: "string",
+          enum: ["draft", "active", "paused", "archived"]
+        },
+        startsAt: {
+          type: "string",
+          description: "Optional ISO start timestamp."
+        },
+        endsAt: {
+          type: "string",
+          description: "Optional ISO end timestamp."
+        }
+      },
+      required: ["publicationId", "title", "sponsorName", "pricingModel", "rateCents"]
+    }
+  },
+  {
+    name: "monetize.offer_remove",
+    description: "Delete a sponsor offer",
+    inputSchema: {
+      type: "object",
+      properties: {
+        publicationId: { type: "string" },
+        offerId: { type: "string" }
+      },
+      required: ["publicationId", "offerId"]
+    }
+  },
+  {
+    name: "section.list",
+    description: "List reusable editor sections for a publication",
+    inputSchema: {
+      type: "object",
+      properties: {
+        publicationId: { type: "string" },
+        limit: { type: "number" }
+      },
+      required: ["publicationId"]
+    }
+  },
+  {
+    name: "section.catalog",
+    description: "List shared marketplace section packs",
+    inputSchema: {
+      type: "object",
+      properties: {
+        publicationId: {
+          type: "string",
+          description: "Optional publication id to include custom packs"
+        }
+      }
+    }
+  },
+  {
+    name: "section.pack_create",
+    description: "Create a custom marketplace pack for a publication",
+    inputSchema: {
+      type: "object",
+      properties: {
+        publicationId: { type: "string" },
+        title: { type: "string" },
+        description: { type: "string" },
+        styleProfile: {
+          type: "object",
+          description: "Optional React Email style profile for this template pack."
+        },
+        sections: {
+          type: "array",
+          items: {
+            type: "object",
+            properties: {
+              name: { type: "string" },
+              contentJson: {
+                type: "array",
+                items: { type: "object" },
+                minItems: 1
+              }
+            },
+            required: ["name", "contentJson"]
+          },
+          minItems: 1
+        }
+      },
+      required: ["publicationId", "title", "sections"]
+    }
+  },
+  {
+    name: "section.pack_update",
+    description: "Update a custom marketplace pack",
+    inputSchema: {
+      type: "object",
+      properties: {
+        publicationId: { type: "string" },
+        packId: { type: "string" },
+        title: { type: "string" },
+        description: { type: "string" },
+        styleProfile: {
+          type: "object",
+          description: "Optional React Email style profile for this template pack."
+        },
+        sections: {
+          type: "array",
+          items: {
+            type: "object",
+            properties: {
+              name: { type: "string" },
+              contentJson: {
+                type: "array",
+                items: { type: "object" },
+                minItems: 1
+              }
+            },
+            required: ["name", "contentJson"]
+          },
+          minItems: 1
+        }
+      },
+      required: ["publicationId", "packId", "title", "sections"]
+    }
+  },
+  {
+    name: "section.pack_remove",
+    description: "Delete a custom marketplace pack",
+    inputSchema: {
+      type: "object",
+      properties: {
+        publicationId: { type: "string" },
+        packId: { type: "string" }
+      },
+      required: ["publicationId", "packId"]
+    }
+  },
+  {
+    name: "section.pack_revisions",
+    description: "List version history for a custom marketplace pack",
+    inputSchema: {
+      type: "object",
+      properties: {
+        publicationId: { type: "string" },
+        packId: { type: "string" },
+        limit: { type: "number" }
+      },
+      required: ["publicationId", "packId"]
+    }
+  },
+  {
+    name: "section.pack_restore_revision",
+    description: "Restore a custom marketplace pack to a specific revision",
+    inputSchema: {
+      type: "object",
+      properties: {
+        publicationId: { type: "string" },
+        packId: { type: "string" },
+        revisionId: { type: "string" }
+      },
+      required: ["publicationId", "packId", "revisionId"]
+    }
+  },
+  {
+    name: "section.import_pack",
+    description: "Import a marketplace pack into reusable sections",
+    inputSchema: {
+      type: "object",
+      properties: {
+        publicationId: { type: "string" },
+        presetId: { type: "string" }
+      },
+      required: ["publicationId", "presetId"]
+    }
+  },
+  {
+    name: "section.create",
+    description: "Create a reusable section snippet",
+    inputSchema: {
+      type: "object",
+      properties: {
+        publicationId: { type: "string" },
+        name: { type: "string" },
+        contentJson: {
+          type: "array",
+          items: { type: "object" },
+          minItems: 1
+        }
+      },
+      required: ["publicationId", "name", "contentJson"]
+    }
+  },
+  {
+    name: "section.update",
+    description: "Update a reusable section snippet",
+    inputSchema: {
+      type: "object",
+      properties: {
+        sectionId: { type: "string" },
+        name: { type: "string" },
+        contentJson: {
+          type: "array",
+          items: { type: "object" },
+          minItems: 1
+        }
+      },
+      required: ["sectionId", "name", "contentJson"]
+    }
+  },
+  {
+    name: "section.remove",
+    description: "Delete a reusable section snippet",
+    inputSchema: {
+      type: "object",
+      properties: {
+        sectionId: { type: "string" }
+      },
+      required: ["sectionId"]
+    }
+  },
+  {
+    name: "issue.preview",
+    description: "Preview newsletter HTML for an issue",
+    inputSchema: {
+      type: "object",
+      properties: {
+        issueId: { type: "string" }
+      },
+      required: ["issueId"]
+    }
+  },
+  {
+    name: "issue.preview_draft",
+    description: "Preview newsletter HTML/text for unsaved draft content",
+    inputSchema: {
+      type: "object",
+      properties: {
+        publicationId: { type: "string" },
+        title: { type: "string" },
+        html: { type: "string" },
+        plainText: { type: "string" },
+        styleProfile: {
+          type: "object",
+          description: "Optional React Email style profile overrides."
+        }
+      },
+      required: ["publicationId", "title", "html"]
+    }
+  },
+  {
+    name: "issue.delivery_progress",
+    description: "Fetch send progress snapshot for an issue",
+    inputSchema: {
+      type: "object",
+      properties: {
+        publicationId: { type: "string" },
+        issueId: { type: "string" }
+      },
+      required: ["publicationId", "issueId"]
+    }
+  },
+  {
+    name: "issue.wait_delivery",
+    description: "Poll issue send progress until sent/failed or timeout",
+    inputSchema: {
+      type: "object",
+      properties: {
+        publicationId: { type: "string" },
+        issueId: { type: "string" },
+        timeoutMs: {
+          type: "number",
+          description: "Optional timeout in milliseconds. Defaults to 60000."
+        },
+        pollIntervalMs: {
+          type: "number",
+          description: "Optional polling interval in milliseconds. Defaults to 2000."
+        }
+      },
+      required: ["publicationId", "issueId"]
+    }
+  },
+  {
+    name: "analytics.poll_results",
+    description: "Fetch poll vote totals for a specific issue",
+    inputSchema: {
+      type: "object",
+      properties: {
+        publicationId: { type: "string" },
+        issueId: { type: "string" }
+      },
+      required: ["publicationId", "issueId"]
+    }
+  },
+  {
+    name: "analytics.issue_performance",
+    description: "Fetch open/click delivery analytics for an issue",
+    inputSchema: {
+      type: "object",
+      properties: {
+        publicationId: { type: "string" },
+        issueId: { type: "string" },
+        range: {
+          type: "string",
+          enum: ["24h", "7d", "30d", "all"],
+          description: "Analytics window. Defaults to all."
+        }
+      },
+      required: ["publicationId", "issueId"]
+    }
+  },
+  {
+    name: "analytics.issue_trend",
+    description: "Fetch daily open/click trend buckets for an issue",
+    inputSchema: {
+      type: "object",
+      properties: {
+        publicationId: { type: "string" },
+        issueId: { type: "string" },
+        range: {
+          type: "string",
+          enum: ["24h", "7d", "30d", "all"],
+          description: "Analytics window. Defaults to all."
+        }
+      },
+      required: ["publicationId", "issueId"]
+    }
+  },
+  {
+    name: "analytics.latest_summary",
+    description: "Fetch latest issue analytics snapshot for a publication",
+    inputSchema: {
+      type: "object",
+      properties: {
+        publicationId: {
+          type: "string",
+          description: "Optional publication id. Falls back to MAILTEA_PUBLICATION_ID."
+        },
+        range: {
+          type: "string",
+          enum: ["24h", "7d", "30d", "all"],
+          description: "Analytics window. Defaults to 7d."
+        }
+      }
+    }
+  },
+  {
+    name: "analytics.issue_export_csv",
+    description: "Export issue performance and poll analytics as CSV",
+    inputSchema: {
+      type: "object",
+      properties: {
+        publicationId: { type: "string" },
+        issueId: { type: "string" },
+        range: {
+          type: "string",
+          enum: ["24h", "7d", "30d", "all"],
+          description: "Analytics window. Defaults to all."
+        },
+        exportType: {
+          type: "string",
+          enum: ["combined", "performance", "polls"],
+          description: "CSV type. Defaults to combined."
+        }
+      },
+      required: ["publicationId", "issueId"]
+    }
+  },
+  {
+    name: "analytics.issue_export_performance_csv",
+    description: "Export issue performance-only analytics as CSV",
+    inputSchema: {
+      type: "object",
+      properties: {
+        publicationId: { type: "string" },
+        issueId: { type: "string" },
+        range: {
+          type: "string",
+          enum: ["24h", "7d", "30d", "all"],
+          description: "Analytics window. Defaults to all."
+        }
+      },
+      required: ["publicationId", "issueId"]
+    }
+  },
+  {
+    name: "analytics.issue_export_polls_csv",
+    description: "Export issue poll-only analytics as CSV",
+    inputSchema: {
+      type: "object",
+      properties: {
+        publicationId: { type: "string" },
+        issueId: { type: "string" },
+        range: {
+          type: "string",
+          enum: ["24h", "7d", "30d", "all"],
+          description: "Analytics window. Defaults to all."
+        }
+      },
+      required: ["publicationId", "issueId"]
+    }
+  },
+  {
+    name: "issue.schedule",
+    description: "Schedule an issue for delivery",
+    inputSchema: {
+      type: "object",
+      properties: {
+        issueId: { type: "string" },
+        scheduledFor: {
+          type: "string",
+          description: "ISO timestamp (optional). Defaults to now."
+        }
+      },
+      required: ["issueId"]
+    }
+  },
+  {
+    name: "issue.unschedule",
+    description: "Cancel an issue schedule and move it back to draft",
+    inputSchema: {
+      type: "object",
+      properties: {
+        issueId: { type: "string" }
+      },
+      required: ["issueId"]
+    }
+  },
+  {
+    name: "issue.publish_to_web",
+    description: "Publish an issue to the publication's public website, making it readable on the web (typically a sent issue).",
+    inputSchema: {
+      type: "object",
+      properties: { issueId: { type: "string" } },
+      required: ["issueId"]
+    }
+  },
+  {
+    name: "issue.unpublish_from_web",
+    description: "Remove an issue from the publication's public website.",
+    inputSchema: {
+      type: "object",
+      properties: { issueId: { type: "string" } },
+      required: ["issueId"]
+    }
+  },
+  {
+    name: "issue.send_now",
+    description: "Send an issue immediately",
+    inputSchema: {
+      type: "object",
+      properties: {
+        issueId: { type: "string" }
+      },
+      required: ["issueId"]
+    }
+  },
+  {
+    name: "issue.send_and_wait",
+    description: "Send an issue now and poll until sent/failed or timeout",
+    inputSchema: {
+      type: "object",
+      properties: {
+        issueId: { type: "string" },
+        timeoutMs: {
+          type: "number",
+          description: "Optional timeout in milliseconds. Defaults to 60000."
+        },
+        pollIntervalMs: {
+          type: "number",
+          description: "Optional polling interval in milliseconds. Defaults to 2000."
+        }
+      },
+      required: ["issueId"]
+    }
+  },
+  {
+    name: "ai.generate_draft",
+    description: "Generate a draft from a prompt",
+    inputSchema: {
+      type: "object",
+      properties: {
+        publicationId: { type: "string" },
+        prompt: { type: "string" },
+        tone: {
+          type: "string",
+          enum: ["neutral", "friendly", "formal"]
+        }
+      },
+      required: ["publicationId", "prompt"]
+    }
+  },
+  {
+    name: "template.create",
+    description: "Create an email template. Provide html (raw HTML) or spec (json-render spec). Spec is recommended \u2014 the platform renders email-safe HTML server-side. Available spec components: Html, Head, Body, Container, Section, Row, Column, Heading, Text, Link, Button, Image, Hr, Preview, Markdown, MailteaHeader, MailteaFooter, MailteaSpacer, MailteaContentBlock.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        publicationId: { type: "string", description: "Publication to create template in" },
+        name: { type: "string", description: "Template name (max 120 chars)" },
+        html: { type: "string", description: "Raw HTML content (use this OR spec)" },
+        spec: {
+          type: "object",
+          description: "json-render spec (flat element map). Use this OR html.",
+          properties: {
+            root: { type: "string" },
+            elements: { type: "object" }
+          },
+          required: ["root", "elements"]
+        },
+        description: { type: "string", description: "Template description (max 500 chars)" },
+        subject: { type: "string", description: "Default email subject line" },
+        variables: {
+          type: "array",
+          description: "Template variables with fallback values",
+          items: {
+            type: "object",
+            properties: {
+              key: { type: "string" },
+              type: { type: "string", enum: ["string", "number"] },
+              fallback_value: {}
+            },
+            required: ["key", "type"]
+          }
+        }
+      },
+      required: ["publicationId", "name"]
+    }
+  },
+  {
+    name: "template.list",
+    description: "List email templates for a publication",
+    inputSchema: {
+      type: "object",
+      properties: {
+        publicationId: { type: "string" },
+        limit: { type: "number", description: "Max results (1-100, default 20)" }
+      },
+      required: ["publicationId"]
+    }
+  },
+  {
+    name: "template.get",
+    description: "Get a single email template by ID, including its spec and rendered HTML",
+    inputSchema: {
+      type: "object",
+      properties: {
+        publicationId: { type: "string" },
+        templateId: { type: "string" }
+      },
+      required: ["publicationId", "templateId"]
+    }
+  },
+  {
+    name: "template.update",
+    description: "Update an email template. Pass only the fields to change. Providing spec re-renders email-safe HTML server-side; providing html switches the template to raw HTML.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        publicationId: { type: "string" },
+        templateId: { type: "string" },
+        name: { type: "string" },
+        html: { type: "string", description: "Raw HTML content (switches the template to raw HTML)." },
+        spec: {
+          type: "object",
+          description: "json-render spec (flat element map). Re-renders email-safe HTML server-side.",
+          properties: { root: { type: "string" }, elements: { type: "object" } },
+          required: ["root", "elements"]
+        },
+        description: { type: "string" },
+        text: { type: "string", description: "Plain-text body." },
+        subject: { type: "string" },
+        from: { type: "string", description: "Default sender address." },
+        reply_to: { type: "string" },
+        variables: {
+          type: "array",
+          items: {
+            type: "object",
+            properties: {
+              key: { type: "string" },
+              type: { type: "string", enum: ["string", "number"] },
+              fallback_value: {}
+            },
+            required: ["key", "type"]
+          }
+        }
+      },
+      required: ["publicationId", "templateId"]
+    }
+  },
+  {
+    name: "template.publish",
+    description: "Publish a draft email template, making it the active version for sends.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        publicationId: { type: "string" },
+        templateId: { type: "string" }
+      },
+      required: ["publicationId", "templateId"]
+    }
+  },
+  {
+    name: "template.duplicate",
+    description: "Duplicate an email template into a new draft copy.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        publicationId: { type: "string" },
+        templateId: { type: "string" }
+      },
+      required: ["publicationId", "templateId"]
+    }
+  },
+  {
+    name: "template.delete",
+    description: "Delete an email template.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        publicationId: { type: "string" },
+        templateId: { type: "string" }
+      },
+      required: ["publicationId", "templateId"]
+    }
+  },
+  {
+    name: "email.send",
+    description: "Send a transactional email to one or more specific recipients. Provide inline content (html and/or text) OR a template reference \u2014 not both. Unlike issue.send_now (which sends a newsletter to the WHOLE publication list), this delivers a one-shot email to the exact addresses in 'to'. Set scheduled_at to send later. Returns the new email's id.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        from: {
+          type: "string",
+          description: "Sender, e.g. 'Acme <hello@acme.com>'. Must use a verified domain."
+        },
+        to: {
+          type: ["string", "array"],
+          items: { type: "string" },
+          description: "Recipient address, or array of up to 50 addresses."
+        },
+        subject: { type: "string", description: "Subject line (max 998 chars)." },
+        html: { type: "string", description: "HTML body. Use this OR template, not both." },
+        text: { type: "string", description: "Plain-text body." },
+        template: {
+          type: "object",
+          description: "Stored template reference to render instead of inline html.",
+          properties: {
+            id: { type: "string" },
+            variables: { type: "object", description: "Template variable values." }
+          },
+          required: ["id"]
+        },
+        cc: { type: ["string", "array"], items: { type: "string" }, description: "CC address(es)." },
+        bcc: { type: ["string", "array"], items: { type: "string" }, description: "BCC address(es)." },
+        reply_to: {
+          type: ["string", "array"],
+          items: { type: "string" },
+          description: "Reply-To address(es)."
+        },
+        scheduled_at: {
+          type: "string",
+          description: "ISO 8601 datetime to schedule the send. Omit to send immediately."
+        },
+        tags: {
+          type: "array",
+          description: "Custom tags for filtering/analytics.",
+          items: {
+            type: "object",
+            properties: { name: { type: "string" }, value: { type: "string" } },
+            required: ["name", "value"]
+          }
+        },
+        headers: { type: "object", description: "Custom email headers (string values)." },
+        attachments: {
+          type: "array",
+          description: "File attachments.",
+          items: {
+            type: "object",
+            properties: {
+              filename: { type: "string" },
+              content: { type: "string", description: "Base64-encoded file content." },
+              content_type: { type: "string" },
+              content_id: { type: "string", description: "For inline images (cid:)." }
+            },
+            required: ["filename", "content"]
+          }
+        }
+      },
+      required: ["from", "to", "subject"]
+    }
+  },
+  {
+    name: "email.batch",
+    description: "Send up to 100 transactional emails in one request. Each item is shaped like email.send but WITHOUT attachments or scheduled_at. Returns the ids in request order.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        emails: {
+          type: "array",
+          description: "1-100 email objects: { from, to, subject, html?|text?|template?, cc?, bcc?, reply_to?, tags?, headers? }.",
+          items: { type: "object" }
+        }
+      },
+      required: ["emails"]
+    }
+  },
+  {
+    name: "email.get",
+    description: "Retrieve a transactional email by id with its delivery status (last_event) and tracking counters (open_count, click_count).",
+    inputSchema: {
+      type: "object",
+      properties: { id: { type: "string" } },
+      required: ["id"]
+    }
+  },
+  {
+    name: "email.reschedule",
+    description: "Reschedule a still-scheduled transactional email to a new time.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        id: { type: "string" },
+        scheduled_at: { type: "string", description: "New ISO 8601 datetime." }
+      },
+      required: ["id", "scheduled_at"]
+    }
+  },
+  {
+    name: "email.cancel",
+    description: "Cancel a scheduled transactional email before it sends.",
+    inputSchema: {
+      type: "object",
+      properties: { id: { type: "string" } },
+      required: ["id"]
+    }
+  },
+  {
+    name: "email.resend",
+    description: "Resend a failed or bounced transactional email \u2014 creates a fresh copy with the same content. Only emails whose status is 'failed' or 'bounced' can be resent; others return an error.",
+    inputSchema: {
+      type: "object",
+      properties: { id: { type: "string" } },
+      required: ["id"]
+    }
+  },
+  {
+    name: "email.list",
+    description: "List transactional emails (most recent first). Filter by status and tags; paginate with limit/offset. Returns id, status, subject, recipient per email.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        status: {
+          type: "string",
+          enum: [
+            "queued",
+            "sent",
+            "delivered",
+            "bounced",
+            "complained",
+            "failed",
+            "scheduled",
+            "canceled"
+          ],
+          description: "Filter by delivery status."
+        },
+        limit: { type: "number", description: "Max results 1-100 (default 50)." },
+        offset: { type: "number", description: "Pagination offset (default 0)." },
+        tag_name: { type: "string", description: "Filter by a custom tag name." },
+        tag_value: { type: "string", description: "Filter by a custom tag value (use with tag_name)." },
+        from_date: { type: "string", description: "ISO 8601 lower bound on created_at." },
+        to_date: { type: "string", description: "ISO 8601 upper bound on created_at." }
+      }
+    }
+  },
+  {
+    name: "email.analytics",
+    description: "Aggregate transactional email metrics over an optional date window: totals, delivered/bounced/opened/clicked counts, per-status counts, and delivery/open/click/bounce rates.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        from_date: { type: "string", description: "ISO 8601 lower bound on created_at." },
+        to_date: { type: "string", description: "ISO 8601 upper bound on created_at." }
+      }
+    }
+  },
+  // --- Inbound email (REST /v1/emails/inbound) -----------------------------
+  // Only inbound_list takes a publicationId; get/attachments/reply resolve
+  // tenancy from the inbound email id.
+  {
+    name: "email.inbound_list",
+    description: "List inbound (received) emails for a publication, most recent first; paginate with limit/cursor. Only this inbound tool needs publicationId \u2014 email.inbound_get/list_attachments/get_attachment/reply resolve tenancy from the email id.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        publicationId: { type: "string" },
+        limit: { type: "number", description: "Max results (1-100, default 20)." },
+        cursor: { type: "string", description: "Opaque pagination cursor from a prior response's next_cursor." }
+      },
+      required: ["publicationId"]
+    }
+  },
+  {
+    name: "email.inbound_get",
+    description: "Retrieve a single inbound email by id (rxemail_) \u2014 headers, html/text body, a signed download URL for the raw message, and its attachments. Tenancy is resolved from the id, so no publicationId is needed.",
+    inputSchema: {
+      type: "object",
+      properties: { id: { type: "string", description: "Inbound email id (rxemail_)." } },
+      required: ["id"]
+    }
+  },
+  {
+    name: "email.inbound_list_attachments",
+    description: "List the attachments of an inbound email, each with a signed download URL. Tenancy is resolved from the email id, so no publicationId is needed.",
+    inputSchema: {
+      type: "object",
+      properties: { id: { type: "string", description: "Inbound email id (rxemail_)." } },
+      required: ["id"]
+    }
+  },
+  {
+    name: "email.inbound_get_attachment",
+    description: "Get a single inbound-email attachment (rxatt_) with a signed download URL. Tenancy is resolved from the parent email id, so no publicationId is needed.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        id: { type: "string", description: "Inbound email id (rxemail_)." },
+        attachmentId: { type: "string", description: "Attachment id (rxatt_)." }
+      },
+      required: ["id", "attachmentId"]
+    }
+  },
+  {
+    name: "email.inbound_reply",
+    description: "Reply to an inbound email. The reply threads automatically \u2014 In-Reply-To, References, and the To (reply target) are all derived by the server from the original, so they are NOT inputs. Provide html and/or text. Omit `from` to send from the verified domain the mail was delivered to. Tenancy is resolved from the email id (no publicationId). Returns the resulting transactional email id (txemail_) with its status.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        id: { type: "string", description: "Inbound email id (rxemail_) to reply to." },
+        from: {
+          type: "object",
+          description: "Sender override. Omit to send from the verified domain the original was delivered to.",
+          properties: {
+            email: { type: "string" },
+            name: { type: "string" }
+          },
+          required: ["email"]
+        },
+        subject: { type: "string", description: "Defaults to the original subject with a single 'Re: ' prefix." },
+        html: { type: "string", description: "HTML body (provide html and/or text)." },
+        text: { type: "string", description: "Plain-text body (provide html and/or text)." },
+        cc: { type: "array", items: { type: "string" }, description: "CC addresses." },
+        bcc: { type: "array", items: { type: "string" }, description: "BCC addresses." },
+        idempotency_key: { type: "string", description: "Optional key to make the reply idempotent (the Idempotency-Key header wins when both are set)." }
+      },
+      required: ["id"]
+    }
+  },
+  {
+    name: "issue.send_test",
+    description: "Send a TEST copy of a newsletter draft to specific recipients (yourself/teammates) to check it before subscribers see it. Renders the issue exactly as a subscriber would receive it and delivers it as a one-shot email with a '[TEST]' subject prefix. This does NOT send to the publication's audience \u2014 use issue.send_now for the real send.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        issueId: { type: "string" },
+        recipients: {
+          type: ["string", "array"],
+          items: { type: "string" },
+          description: "Test recipient address, or array of addresses."
+        },
+        from: {
+          type: "string",
+          description: "Sender, e.g. 'Acme <hello@acme.com>'. Must use a verified domain."
+        }
+      },
+      required: ["issueId", "recipients", "from"]
+    }
+  },
+  // --- Email sending domains (REST /v1/domains) ----------------------------
+  // Provision and verify the 'from' domain that email.send / issue.send_test
+  // require. (Distinct from publication.domain_* which manage the Traefik
+  // website surface of the same publication.)
+  {
+    name: "domain.create",
+    description: "Register an email sending domain for a publication. Returns the DNS TXT record (in 'records') the operator must add before the domain can be verified. Set purpose to 'email' (or 'both') to use it as a sending 'from' domain.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        publicationId: { type: "string" },
+        name: { type: "string", description: "Domain host, e.g. 'mail.acme.com'." },
+        purpose: {
+          type: "string",
+          enum: ["email", "site", "both"],
+          description: "Use 'email' or 'both' for a sending domain. Defaults to 'site'."
+        },
+        is_primary: { type: "boolean" }
+      },
+      required: ["publicationId", "name"]
+    }
+  },
+  {
+    name: "domain.list",
+    description: "List email/site domains for a publication.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        publicationId: { type: "string" },
+        limit: { type: "number", description: "Max results (1-100, default 20)." }
+      },
+      required: ["publicationId"]
+    }
+  },
+  {
+    name: "domain.get",
+    description: "Get a single domain including the DNS 'records' to add for verification.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        publicationId: { type: "string" },
+        domainId: { type: "string" }
+      },
+      required: ["publicationId", "domainId"]
+    }
+  },
+  {
+    name: "domain.verify",
+    description: "Verify a domain by checking its DNS TXT record. On success the domain's status becomes 'verified' and it can be used as a sending 'from' domain.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        publicationId: { type: "string" },
+        domainId: { type: "string" }
+      },
+      required: ["publicationId", "domainId"]
+    }
+  },
+  {
+    name: "domain.update",
+    description: "Update a domain's purpose (email/site/both) or primary flag.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        publicationId: { type: "string" },
+        domainId: { type: "string" },
+        purpose: { type: "string", enum: ["email", "site", "both"] },
+        is_primary: { type: "boolean" }
+      },
+      required: ["publicationId", "domainId"]
+    }
+  },
+  {
+    name: "domain.delete",
+    description: "Remove a domain from a publication.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        publicationId: { type: "string" },
+        domainId: { type: "string" }
+      },
+      required: ["publicationId", "domainId"]
+    }
+  },
+  // --- Tracking sub-domains (CNAME, under a domain) -------------------------
+  {
+    name: "domain.tracking_create",
+    description: "Add a tracking sub-domain (CNAME) under a domain \u2014 used to serve open-pixel/click-tracking links from your own domain. Returns the CNAME record to add, then call domain.tracking_verify.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        publicationId: { type: "string" },
+        domainId: { type: "string", description: "Parent domain ID." },
+        subdomain: {
+          type: "string",
+          description: "Sub-domain label (lowercase alphanumeric and hyphens), e.g. 'links'."
+        }
+      },
+      required: ["publicationId", "domainId", "subdomain"]
+    }
+  },
+  {
+    name: "domain.tracking_list",
+    description: "List tracking sub-domains for a domain.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        publicationId: { type: "string" },
+        domainId: { type: "string" }
+      },
+      required: ["publicationId", "domainId"]
+    }
+  },
+  {
+    name: "domain.tracking_verify",
+    description: "Verify a tracking sub-domain by checking its CNAME record; status becomes 'verified'.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        publicationId: { type: "string" },
+        domainId: { type: "string" },
+        trackingDomainId: { type: "string" }
+      },
+      required: ["publicationId", "domainId", "trackingDomainId"]
+    }
+  },
+  {
+    name: "domain.tracking_delete",
+    description: "Remove a tracking sub-domain.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        publicationId: { type: "string" },
+        domainId: { type: "string" },
+        trackingDomainId: { type: "string" }
+      },
+      required: ["publicationId", "domainId", "trackingDomainId"]
+    }
+  },
+  // --- Outbound webhooks (REST /v1/webhooks/endpoints) ----------------------
+  {
+    name: "webhook.create",
+    description: "Register an outbound webhook endpoint that receives delivery/engagement events. Returns a signing_secret (shown only once) used to verify payloads.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        publicationId: { type: "string" },
+        endpoint: { type: "string", description: "HTTPS URL to deliver events to." },
+        events: {
+          type: "array",
+          items: { type: "string" },
+          description: "Event types, e.g. email.received, email.sent, email.delivered, email.bounced, email.opened, email.clicked, contact.created, contact.unsubscribed."
+        }
+      },
+      required: ["publicationId", "endpoint", "events"]
+    }
+  },
+  {
+    name: "webhook.list",
+    description: "List outbound webhooks for a publication (signing secrets omitted).",
+    inputSchema: {
+      type: "object",
+      properties: {
+        publicationId: { type: "string" },
+        limit: { type: "number", description: "Max results (1-100, default 20)." }
+      },
+      required: ["publicationId"]
+    }
+  },
+  {
+    name: "webhook.get",
+    description: "Get a single outbound webhook by ID.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        publicationId: { type: "string" },
+        webhookId: { type: "string" }
+      },
+      required: ["publicationId", "webhookId"]
+    }
+  },
+  {
+    name: "webhook.update",
+    description: "Update a webhook's endpoint, subscribed events, or enabled/disabled status.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        publicationId: { type: "string" },
+        webhookId: { type: "string" },
+        endpoint: { type: "string" },
+        events: { type: "array", items: { type: "string" } },
+        status: { type: "string", enum: ["enabled", "disabled"] }
+      },
+      required: ["publicationId", "webhookId"]
+    }
+  },
+  {
+    name: "webhook.delete",
+    description: "Delete an outbound webhook.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        publicationId: { type: "string" },
+        webhookId: { type: "string" }
+      },
+      required: ["publicationId", "webhookId"]
+    }
+  },
+  // --- Audience segments (REST /v1/segments) --------------------------------
+  {
+    name: "segment.create",
+    description: "Create a saved audience segment defined by a status filter and/or a query filter (filter-based, not manual membership).",
+    inputSchema: {
+      type: "object",
+      properties: {
+        publicationId: { type: "string" },
+        name: { type: "string" },
+        description: { type: "string" },
+        status_filter: { type: "string", enum: ["active", "unsubscribed", "suppressed"] },
+        query_filter: { type: "string", description: "Search/filter expression over contacts." }
+      },
+      required: ["publicationId", "name"]
+    }
+  },
+  {
+    name: "segment.list",
+    description: "List saved audience segments for a publication.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        publicationId: { type: "string" },
+        limit: { type: "number", description: "Max results (1-100, default 20)." }
+      },
+      required: ["publicationId"]
+    }
+  },
+  {
+    name: "segment.get",
+    description: "Get a single audience segment by ID.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        publicationId: { type: "string" },
+        segmentId: { type: "string" }
+      },
+      required: ["publicationId", "segmentId"]
+    }
+  },
+  {
+    name: "segment.update",
+    description: "Update an audience segment's name, description, or filters.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        publicationId: { type: "string" },
+        segmentId: { type: "string" },
+        name: { type: "string" },
+        description: { type: "string" },
+        status_filter: {
+          type: ["string", "null"],
+          enum: ["active", "unsubscribed", "suppressed", null],
+          description: "Filter by contact status, or null to clear it."
+        },
+        query_filter: {
+          type: ["string", "null"],
+          description: "Search/filter expression, or null to clear it."
+        }
+      },
+      required: ["publicationId", "segmentId"]
+    }
+  },
+  {
+    name: "segment.delete",
+    description: "Delete an audience segment.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        publicationId: { type: "string" },
+        segmentId: { type: "string" }
+      },
+      required: ["publicationId", "segmentId"]
+    }
+  },
+  // --- Contact custom properties (REST /v1/contact-properties; team-scoped) -
+  {
+    name: "contact_property.create",
+    description: "Define a custom contact property (custom field) for the team. Property values are set per-contact via contact.set_properties.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        key: {
+          type: "string",
+          description: "Property key (starts with a letter; letters, numbers, underscores)."
+        },
+        type: { type: "string", enum: ["string", "number"] },
+        fallback_value: { description: "Default value when a contact has none (matches type)." },
+        description: { type: "string" }
+      },
+      required: ["key", "type"]
+    }
+  },
+  {
+    name: "contact_property.list",
+    description: "List the team's custom contact property definitions.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        limit: { type: "number", description: "Max results (1-100, default 20)." }
+      }
+    }
+  },
+  {
+    name: "contact_property.update",
+    description: "Update a custom contact property's fallback value or description.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        propertyId: { type: "string" },
+        fallback_value: {},
+        description: { type: "string" }
+      },
+      required: ["propertyId"]
+    }
+  },
+  {
+    name: "contact_property.delete",
+    description: "Delete a custom contact property definition.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        propertyId: { type: "string" }
+      },
+      required: ["propertyId"]
+    }
+  },
+  // --- Contact completeness (REST GET/DELETE + tRPC property values) --------
+  {
+    name: "contact.get",
+    description: "Get a single contact by its ID or email address.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        publicationId: { type: "string" },
+        idOrEmail: { type: "string", description: "Contact ID or email address." }
+      },
+      required: ["publicationId", "idOrEmail"]
+    }
+  },
+  {
+    name: "contact.delete",
+    description: "Permanently delete a contact by its ID or email address.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        publicationId: { type: "string" },
+        idOrEmail: { type: "string", description: "Contact ID or email address." }
+      },
+      required: ["publicationId", "idOrEmail"]
+    }
+  },
+  {
+    name: "contact.get_properties",
+    description: "Read a contact's custom property values.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        publicationId: { type: "string" },
+        contactId: { type: "string" }
+      },
+      required: ["publicationId", "contactId"]
+    }
+  },
+  {
+    name: "contact.set_properties",
+    description: "Set a contact's custom property values. Each value references a property by propertyId (from contact_property.list/create).",
+    inputSchema: {
+      type: "object",
+      properties: {
+        publicationId: { type: "string" },
+        contactId: { type: "string" },
+        values: {
+          type: "array",
+          items: {
+            type: "object",
+            properties: {
+              propertyId: { type: "string" },
+              value: { type: "string" }
+            },
+            required: ["propertyId", "value"]
+          }
+        }
+      },
+      required: ["publicationId", "contactId", "values"]
+    }
+  },
+  // --- Tag definitions (REST /v1/tags) -------------------------------------
+  {
+    name: "tag.create",
+    description: "Create a tag definition. NOTE: tags cannot yet be assigned to individual contacts via the API \u2014 this manages tag definitions only.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        publicationId: { type: "string" },
+        name: { type: "string" },
+        default_subscription: { type: "string", enum: ["opt_in", "opt_out"] },
+        description: { type: "string" },
+        visibility: { type: "string", enum: ["public", "private"] }
+      },
+      required: ["publicationId", "name", "default_subscription"]
+    }
+  },
+  {
+    name: "tag.list",
+    description: "List tag definitions for a publication.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        publicationId: { type: "string" },
+        limit: { type: "number", description: "Max results (1-100, default 20)." }
+      },
+      required: ["publicationId"]
+    }
+  },
+  {
+    name: "tag.update",
+    description: "Update a tag definition's name, description, default subscription, or visibility.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        publicationId: { type: "string" },
+        tagId: { type: "string" },
+        name: { type: "string" },
+        description: { type: "string" },
+        default_subscription: { type: "string", enum: ["opt_in", "opt_out"] },
+        visibility: { type: "string", enum: ["public", "private"] }
+      },
+      required: ["publicationId", "tagId"]
+    }
+  },
+  {
+    name: "tag.delete",
+    description: "Delete a tag definition.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        publicationId: { type: "string" },
+        tagId: { type: "string" }
+      },
+      required: ["publicationId", "tagId"]
+    }
+  },
+  // --- API keys (REST /v1/api-keys; requires settings:write) ----------------
+  {
+    name: "api_key.create",
+    description: "Create an API key (PAT). Requires the calling token to hold settings:write AND every scope the new key would grant. The token value is returned ONCE \u2014 store it securely. 'full_access' grants all scopes; 'sending_access' grants issue read/write/send only.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        name: { type: "string", description: "Human label for the key (max 50 chars)." },
+        permission: {
+          type: "string",
+          enum: ["full_access", "sending_access"],
+          description: "Defaults to full_access."
+        },
+        domain_id: { type: "string", description: "Optional publication scope for sending_access." }
+      },
+      required: ["name"]
+    }
+  },
+  {
+    name: "api_key.list",
+    description: "List the team's API keys (token values are never returned).",
+    inputSchema: {
+      type: "object",
+      properties: {}
+    }
+  },
+  {
+    name: "api_key.revoke",
+    description: "Revoke (delete) an API key by its ID.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        keyId: { type: "string" }
+      },
+      required: ["keyId"]
+    }
+  }
+];
+var MCP_RESOURCES = [
+  {
+    uri: "publication://current/brand-guidelines",
+    name: "Brand Guidelines",
+    description: "Publication writing style and visual preferences",
+    mimeType: "application/json"
+  },
+  {
+    uri: "mailtea://capabilities",
+    name: "Mailtea MCP Capabilities",
+    description: "Tool and endpoint capabilities for this MCP runtime",
+    mimeType: "application/json"
+  },
+  {
+    uri: "analytics://current/latest-summary",
+    name: "Latest Analytics Summary",
+    description: "Most recent newsletter engagement snapshot",
+    mimeType: "application/json"
+  }
+];
+var MCP_PROMPTS = [
+  {
+    name: "newsletter.draft_from_brief",
+    description: "Create a newsletter draft from a short brief"
+  },
+  {
+    name: "newsletter.subject_line_pack",
+    description: "Generate subject line variants"
+  }
+];
+function response(id, result) {
+  return {
+    jsonrpc: "2.0",
+    id,
+    result
+  };
+}
+function error(id, code, message, data) {
+  return {
+    jsonrpc: "2.0",
+    id,
+    error: {
+      code,
+      message,
+      data
+    }
+  };
+}
+function asObject(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    return {};
+  }
+  return value;
+}
+function asOptionalString(value) {
+  if (typeof value !== "string") {
+    return void 0;
+  }
+  const trimmed = value.trim();
+  return trimmed.length > 0 ? trimmed : void 0;
+}
+function readRequiredString(args, key) {
+  const value = asOptionalString(args[key]);
+  if (!value) {
+    throw new Error(`Missing required string argument: ${key}`);
+  }
+  return value;
+}
+function readIssueAnalyticsRange(args, key) {
+  const value = asOptionalString(args[key]);
+  return parseIssueAnalyticsRange(value, key);
+}
+function readIssueAnalyticsExportType(args, key) {
+  const value = asOptionalString(args[key]);
+  if (!value) {
+    return void 0;
+  }
+  if (value === "combined" || value === "performance" || value === "polls") {
+    return value;
+  }
+  throw new Error(`Argument ${key} must be one of: combined, performance, polls`);
+}
+function parseIssueAnalyticsRange(value, key) {
+  if (!value) {
+    return void 0;
+  }
+  if (value === "24h" || value === "7d" || value === "30d" || value === "all") {
+    return value;
+  }
+  throw new Error(`Argument ${key} must be one of: 24h, 7d, 30d, all`);
+}
+function readContactStatus(args, key) {
+  const value = asOptionalString(args[key]);
+  if (!value) {
+    return void 0;
+  }
+  if (value === "active" || value === "unsubscribed" || value === "suppressed") {
+    return value;
+  }
+  throw new Error(`Argument ${key} must be one of: active, unsubscribed, suppressed`);
+}
+function readSponsorOfferStatus(args, key) {
+  const value = asOptionalString(args[key]);
+  if (!value) {
+    return void 0;
+  }
+  if (value === "draft" || value === "active" || value === "paused" || value === "archived") {
+    return value;
+  }
+  throw new Error(`Argument ${key} must be one of: draft, active, paused, archived`);
+}
+function readSponsorOfferPricingModel(args, key) {
+  const value = asOptionalString(args[key]);
+  if (!value) {
+    return void 0;
+  }
+  if (value === "flat" || value === "cpm") {
+    return value;
+  }
+  throw new Error(`Argument ${key} must be one of: flat, cpm`);
+}
+function readOptionalNumber(args, key) {
+  const value = args[key];
+  if (value === void 0) {
+    return void 0;
+  }
+  if (typeof value === "string" && value.trim() !== "") {
+    const parsed = Number(value);
+    if (Number.isFinite(parsed)) {
+      return parsed;
+    }
+  }
+  if (typeof value !== "number" || !Number.isFinite(value)) {
+    throw new Error(`Argument ${key} must be a finite number`);
+  }
+  return value;
+}
+function sleep(ms) {
+  return new Promise((resolve) => {
+    setTimeout(resolve, ms);
+  });
+}
+function readOptionalBoolean(args, key) {
+  const value = args[key];
+  if (value === void 0) {
+    return void 0;
+  }
+  if (typeof value !== "boolean") {
+    throw new Error(`Argument ${key} must be a boolean`);
+  }
+  return value;
+}
+function readOptionalJsonObject(args, key) {
+  const value = args[key];
+  if (value === void 0) {
+    return void 0;
+  }
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    throw new Error(`Argument ${key} must be a JSON object`);
+  }
+  return value;
+}
+function readRequiredJsonObjectArray(args, key) {
+  const value = args[key];
+  if (!Array.isArray(value) || value.length === 0) {
+    throw new Error(`Argument ${key} must be a non-empty array of objects`);
+  }
+  return value.map((item) => {
+    if (!item || typeof item !== "object" || Array.isArray(item)) {
+      throw new Error(`Argument ${key} must be a non-empty array of objects`);
+    }
+    return item;
+  });
+}
+function readRequiredPackSections(args, key) {
+  const rows = readRequiredJsonObjectArray(args, key);
+  return rows.map((row) => {
+    const name = asOptionalString(row.name);
+    if (!name) {
+      throw new Error(`Argument ${key} item requires a non-empty name`);
+    }
+    const contentJson = row.contentJson;
+    if (!Array.isArray(contentJson) || contentJson.length === 0) {
+      throw new Error(`Argument ${key} item requires non-empty contentJson`);
+    }
+    const nodes = contentJson.flatMap((node) => {
+      if (!node || typeof node !== "object" || Array.isArray(node)) {
+        return [];
+      }
+      return [node];
+    });
+    if (nodes.length === 0) {
+      throw new Error(`Argument ${key} item requires non-empty contentJson`);
+    }
+    return {
+      name,
+      contentJson: nodes
+    };
+  });
+}
+function resolveApiBaseUrl(options) {
+  return (options.apiBaseUrl ?? process.env.MAILTEA_API_BASE_URL ?? DEFAULT_API_BASE_URL).replace(/\/+$/, "");
+}
+function resolveToken(options) {
+  return options.token ?? process.env.MAILTEA_API_TOKEN ?? null;
+}
+function resolvePublicationId(options) {
+  return asOptionalString(options.publicationId ?? void 0) ?? asOptionalString(process.env.MAILTEA_PUBLICATION_ID) ?? null;
+}
+function parseAnalyticsSummaryUri(uri) {
+  let parsed;
+  try {
+    parsed = new URL(uri);
+  } catch {
+    return null;
+  }
+  if (parsed.protocol !== "analytics:" || parsed.hostname !== "current" || parsed.pathname !== "/latest-summary") {
+    return null;
+  }
+  const publicationId = asOptionalString(parsed.searchParams.get("publicationId"));
+  const range = parseIssueAnalyticsRange(asOptionalString(parsed.searchParams.get("range")), "range") ?? "7d";
+  return { publicationId, range };
+}
+async function loadLatestAnalyticsSummary(options, input) {
+  const publicationId = input.publicationId ?? resolvePublicationId(options);
+  if (!publicationId) {
+    return {
+      status: "missing_publication_context",
+      message: "Set MAILTEA_PUBLICATION_ID or pass publicationId in the request.",
+      exampleUri: "analytics://current/latest-summary?publicationId=pub_demo"
+    };
+  }
+  const summary = await callTrpc(
+    "issue.latestSummary",
+    {
+      publicationId,
+      range: input.range
+    },
+    options,
+    "query"
+  );
+  return summary;
+}
+function makeToolResult(text, structuredContent) {
+  return {
+    content: [
+      {
+        type: "text",
+        text
+      }
+    ],
+    ...structuredContent ? { structuredContent } : {}
+  };
+}
+function toErrorMessage(err) {
+  return err instanceof Error ? err.message : "Internal error";
+}
+async function callTrpc(path, input, options, procedureType = "mutation") {
+  const fetchImpl = options.fetchImpl ?? fetch;
+  const apiBaseUrl = resolveApiBaseUrl(options);
+  const token = resolveToken(options);
+  if (!token) {
+    throw new Error(
+      "Missing API token. Set MAILTEA_API_TOKEN or pass Authorization header when using /mcp."
+    );
+  }
+  const headers = {
+    authorization: `Bearer ${token}`
+  };
+  const request = procedureType === "query" ? {
+    url: `${apiBaseUrl}/trpc/${path}?input=${encodeURIComponent(
+      JSON.stringify(input ?? {})
+    )}`,
+    init: {
+      method: "GET",
+      headers
+    }
+  } : {
+    url: `${apiBaseUrl}/trpc/${path}`,
+    init: {
+      method: "POST",
+      headers: {
+        ...headers,
+        "content-type": "application/json"
+      },
+      body: JSON.stringify(input)
+    }
+  };
+  const httpResponse = await fetchImpl(request.url, request.init);
+  const payload = await httpResponse.json().catch(() => null);
+  if (!httpResponse.ok || payload?.error) {
+    throw new Error(
+      payload?.error?.message ?? `${httpResponse.status} ${httpResponse.statusText}`
+    );
+  }
+  if (!payload?.result || typeof payload.result !== "object" || !("data" in payload.result)) {
+    throw new Error(`Malformed tRPC response for ${path}`);
+  }
+  return payload.result.data;
+}
+async function callRestApi(method, path, body, options) {
+  const fetchImpl = options.fetchImpl ?? fetch;
+  const apiBaseUrl = resolveApiBaseUrl(options);
+  const token = resolveToken(options);
+  if (!token) {
+    throw new Error("Missing API token.");
+  }
+  const headers = {
+    authorization: `Bearer ${token}`
+  };
+  const init = { method, headers };
+  if (body !== void 0) {
+    headers["content-type"] = "application/json";
+    init.body = JSON.stringify(body);
+  }
+  const httpResponse = await fetchImpl(`${apiBaseUrl}${path}`, init);
+  const payload = await httpResponse.json().catch(() => null);
+  if (!httpResponse.ok) {
+    throw new Error(
+      payload?.error ?? `${httpResponse.status} ${httpResponse.statusText}`
+    );
+  }
+  return payload;
+}
+var EMAIL_SEND_FIELDS = [
+  "from",
+  "to",
+  "subject",
+  "html",
+  "text",
+  "template",
+  "cc",
+  "bcc",
+  "reply_to",
+  "scheduled_at",
+  "tags",
+  "headers",
+  "attachments"
+];
+async function runTool(toolName, args, options) {
+  if (toolName === "auth.me") {
+    const me = await callTrpc("auth.me", {}, options, "query");
+    return makeToolResult(
+      me.userId ? `Authenticated as ${me.role} (${me.userId})` : "Not authenticated",
+      me
+    );
+  }
+  if (toolName === "issue.create_draft") {
+    const publicationId = readRequiredString(args, "publicationId");
+    const title = readRequiredString(args, "title");
+    const kind = args.kind === "broadcast" ? "broadcast" : args.kind === "newsletter" ? "newsletter" : void 0;
+    const templateId = asOptionalString(args.templateId);
+    const variables = args.variables;
+    const contentHtml = asOptionalString(args.contentHtml);
+    const contentSpec = args.contentSpec;
+    let resolvedHtml = contentHtml;
+    if (!templateId && contentSpec && typeof contentSpec === "object" && contentSpec.root) {
+      const rendered = await callRestApi(
+        "POST",
+        "/v1/templates/render",
+        { spec: contentSpec },
+        options
+      );
+      resolvedHtml = rendered.html;
+    }
+    const draft = await callTrpc(
+      "issue.createDraft",
+      {
+        publicationId,
+        title,
+        ...kind ? { kind } : {},
+        ...templateId ? { templateId, ...variables ? { variables } : {} } : resolvedHtml ? {
+          contentJson: {
+            type: "mailtea.rich.v1",
+            html: resolvedHtml
+          }
+        } : {}
+      },
+      options
+    );
+    return makeToolResult(`Draft created: ${draft.id}`, { issue: draft });
+  }
+  if (toolName === "issue.get_editor") {
+    const issueId = readRequiredString(args, "issueId");
+    const issue = await callTrpc(
+      "issue.getEditor",
+      { issueId },
+      options,
+      "query"
+    );
+    return makeToolResult(`Loaded editor state for ${issue.id} (${issue.status})`, { issue });
+  }
+  if (toolName === "issue.update_draft") {
+    const issueId = readRequiredString(args, "issueId");
+    const title = readRequiredString(args, "title");
+    const contentHtml = asOptionalString(args.contentHtml);
+    const contentSpec = args.contentSpec;
+    let resolvedHtml = contentHtml;
+    if (contentSpec && typeof contentSpec === "object" && contentSpec.root) {
+      const rendered = await callRestApi(
+        "POST",
+        "/v1/templates/render",
+        { spec: contentSpec },
+        options
+      );
+      resolvedHtml = rendered.html;
+    }
+    const draft = await callTrpc(
+      "issue.updateDraft",
+      {
+        issueId,
+        title,
+        ...resolvedHtml ? {
+          contentJson: {
+            type: "mailtea.rich.v1",
+            html: resolvedHtml
+          }
+        } : {}
+      },
+      options
+    );
+    return makeToolResult(`Draft updated: ${draft.id}`, { issue: draft });
+  }
+  if (toolName === "issue.remove_draft") {
+    const issueId = readRequiredString(args, "issueId");
+    const removed = await callTrpc(
+      "issue.removeDraft",
+      { issueId },
+      options
+    );
+    return makeToolResult(`Draft removed: ${removed.issueId}`, removed);
+  }
+  if (toolName === "issue.list_recent") {
+    const publicationId = readRequiredString(args, "publicationId");
+    const requestedLimit = readOptionalNumber(args, "limit");
+    const limit = Math.max(1, Math.min(50, Math.trunc(requestedLimit ?? 10)));
+    const rows = await callTrpc(
+      "issue.listRecent",
+      { publicationId, limit },
+      options,
+      "query"
+    );
+    return makeToolResult(
+      rows.length === 0 ? `No issues found for ${publicationId}` : `Loaded ${rows.length} issues for ${publicationId}`,
+      {
+        publicationId,
+        issues: rows
+      }
+    );
+  }
+  if (toolName === "publication.list") {
+    const workspaces = await callTrpc(
+      "publication.listMine",
+      {},
+      options,
+      "query"
+    );
+    return makeToolResult(
+      workspaces.length === 0 ? "No publication workspaces available for this identity yet" : `Loaded ${workspaces.length} publication workspaces`,
+      {
+        publications: workspaces
+      }
+    );
+  }
+  if (toolName === "publication.create") {
+    const publicationId = asOptionalString(args.publicationId);
+    const name = readRequiredString(args, "name");
+    const timezone = asOptionalString(args.timezone);
+    const result = await callTrpc(
+      "publication.create",
+      {
+        ...publicationId ? { publicationId } : {},
+        name,
+        ...timezone ? { timezone } : {}
+      },
+      options
+    );
+    return makeToolResult(`Publication created: ${result.publication.id}`, result);
+  }
+  if (toolName === "publication.domain_list") {
+    const publicationId = readRequiredString(args, "publicationId");
+    const requestedLimit = readOptionalNumber(args, "limit");
+    const limit = Math.max(1, Math.min(100, Math.trunc(requestedLimit ?? 50)));
+    const domains = await callTrpc(
+      "publication.domains",
+      {
+        publicationId,
+        limit
+      },
+      options,
+      "query"
+    );
+    return makeToolResult(
+      domains.length === 0 ? `No custom domains configured for ${publicationId}` : `Loaded ${domains.length} custom domains for ${publicationId}`,
+      { publicationId, domains }
+    );
+  }
+  if (toolName === "publication.domain_upsert") {
+    const publicationId = readRequiredString(args, "publicationId");
+    const host = readRequiredString(args, "host");
+    const isPrimary = readOptionalBoolean(args, "isPrimary");
+    const proxyTarget = asOptionalString(args.proxyTarget);
+    const result = await callTrpc(
+      "publication.domainUpsert",
+      {
+        publicationId,
+        host,
+        ...typeof isPrimary === "boolean" ? { isPrimary } : {},
+        ...proxyTarget ? { proxyTarget } : {}
+      },
+      options
+    );
+    return makeToolResult(
+      `Publication domain saved: ${result.domain.host} (${result.domain.status})`,
+      result
+    );
+  }
+  if (toolName === "publication.domain_verify") {
+    const publicationId = readRequiredString(args, "publicationId");
+    const domainId = readRequiredString(args, "domainId");
+    const verificationValue = asOptionalString(args.verificationValue);
+    const result = await callTrpc(
+      "publication.domainVerify",
+      {
+        publicationId,
+        domainId,
+        ...verificationValue ? { verificationValue } : {}
+      },
+      options
+    );
+    return makeToolResult(
+      `Publication domain verified: ${result.domain.host}`,
+      result
+    );
+  }
+  if (toolName === "publication.domain_set_primary") {
+    const publicationId = readRequiredString(args, "publicationId");
+    const domainId = readRequiredString(args, "domainId");
+    const result = await callTrpc(
+      "publication.domainSetPrimary",
+      {
+        publicationId,
+        domainId
+      },
+      options
+    );
+    return makeToolResult(`Primary domain set: ${result.domain.host}`, result);
+  }
+  if (toolName === "publication.domain_remove") {
+    const publicationId = readRequiredString(args, "publicationId");
+    const domainId = readRequiredString(args, "domainId");
+    const result = await callTrpc(
+      "publication.domainRemove",
+      {
+        publicationId,
+        domainId
+      },
+      options
+    );
+    return makeToolResult(`Publication domain removed: ${result.domainId}`, result);
+  }
+  if (toolName === "publication.domain_traefik_preview") {
+    const publicationId = readRequiredString(args, "publicationId");
+    const preview = await callTrpc(
+      "publication.domainTraefikPreview",
+      {
+        publicationId
+      },
+      options,
+      "query"
+    );
+    return makeToolResult(
+      `Generated Traefik preview for ${publicationId} (${preview.entries.length} domains)`,
+      preview
+    );
+  }
+  if (toolName === "contact.list") {
+    const publicationId = readRequiredString(args, "publicationId");
+    const status = readContactStatus(args, "status");
+    const query = asOptionalString(args.query);
+    const requestedLimit = readOptionalNumber(args, "limit");
+    const limit = Math.max(1, Math.min(500, Math.trunc(requestedLimit ?? 200)));
+    const contacts = await callTrpc(
+      "contact.list",
+      {
+        publicationId,
+        ...status ? { status } : {},
+        ...query ? { query } : {},
+        limit
+      },
+      options,
+      "query"
+    );
+    return makeToolResult(
+      contacts.length === 0 ? `No contacts found for ${publicationId}` : `Loaded ${contacts.length} contacts for ${publicationId}`,
+      {
+        publicationId,
+        contacts
+      }
+    );
+  }
+  if (toolName === "contact.upsert") {
+    const publicationId = readRequiredString(args, "publicationId");
+    const email = readRequiredString(args, "email");
+    const referrerContactId = asOptionalString(args.referrerContactId);
+    const contact = await callTrpc(
+      "contact.upsert",
+      {
+        publicationId,
+        email,
+        ...referrerContactId ? { referrerContactId } : {}
+      },
+      options
+    );
+    return makeToolResult(`Contact saved: ${contact.id} (${contact.status})`, {
+      contact
+    });
+  }
+  if (toolName === "contact.set_status") {
+    const publicationId = readRequiredString(args, "publicationId");
+    const contactId = readRequiredString(args, "contactId");
+    const status = readContactStatus(args, "status");
+    if (!status) {
+      throw new Error("status is required");
+    }
+    const contact = await callTrpc(
+      "contact.setStatus",
+      {
+        publicationId,
+        contactId,
+        status
+      },
+      options
+    );
+    return makeToolResult(`Contact status updated: ${contact.id} -> ${contact.status}`, {
+      contact
+    });
+  }
+  if (toolName === "contact.import_csv") {
+    const publicationId = readRequiredString(args, "publicationId");
+    const csvText = readRequiredString(args, "csvText");
+    const result = await callTrpc(
+      "contact.importCsv",
+      {
+        publicationId,
+        csvText
+      },
+      options
+    );
+    return makeToolResult(
+      `Contact import complete for ${publicationId}: +${result.createdCount} new, ${result.reactivatedCount} reactivated, ${result.invalidCount} invalid`,
+      result
+    );
+  }
+  if (toolName === "contact.referral_summary") {
+    const publicationId = readRequiredString(args, "publicationId");
+    const requestedLimit = readOptionalNumber(args, "limit");
+    const limit = Math.max(1, Math.min(100, Math.trunc(requestedLimit ?? 20)));
+    const summary = await callTrpc(
+      "contact.referralSummary",
+      {
+        publicationId,
+        limit
+      },
+      options,
+      "query"
+    );
+    return makeToolResult(
+      summary.totalReferrals === 0 ? `No referrals tracked yet for ${publicationId}` : `Loaded referral summary for ${publicationId}: ${summary.totalReferrals} total referrals`,
+      summary
+    );
+  }
+  if (toolName === "contact.referral_milestones") {
+    const publicationId = readRequiredString(args, "publicationId");
+    const requestedLimit = readOptionalNumber(args, "limit");
+    const limit = Math.max(1, Math.min(200, Math.trunc(requestedLimit ?? 100)));
+    const milestones = await callTrpc(
+      "contact.referralMilestones",
+      {
+        publicationId,
+        limit
+      },
+      options,
+      "query"
+    );
+    return makeToolResult(
+      milestones.length === 0 ? `No referral milestones configured for ${publicationId}` : `Loaded ${milestones.length} referral milestones for ${publicationId}`,
+      { publicationId, milestones }
+    );
+  }
+  if (toolName === "contact.referral_milestone_upsert") {
+    const publicationId = readRequiredString(args, "publicationId");
+    const title = readRequiredString(args, "title");
+    const description = asOptionalString(args.description);
+    const milestoneId = asOptionalString(args.milestoneId);
+    const referralCountInput = readOptionalNumber(args, "referralCount");
+    if (typeof referralCountInput !== "number" || !Number.isFinite(referralCountInput)) {
+      throw new Error("referralCount is required and must be a number");
+    }
+    const referralCount = Math.max(1, Math.trunc(referralCountInput));
+    const result = await callTrpc(
+      "contact.upsertReferralMilestone",
+      {
+        publicationId,
+        ...milestoneId ? { milestoneId } : {},
+        title,
+        ...description ? { description } : {},
+        referralCount
+      },
+      options
+    );
+    return makeToolResult(
+      `Referral milestone saved: ${result.milestone.id} (${result.rewardedCount} rewards granted)`,
+      result
+    );
+  }
+  if (toolName === "contact.referral_milestone_remove") {
+    const publicationId = readRequiredString(args, "publicationId");
+    const milestoneId = readRequiredString(args, "milestoneId");
+    const result = await callTrpc(
+      "contact.removeReferralMilestone",
+      {
+        publicationId,
+        milestoneId
+      },
+      options
+    );
+    return makeToolResult(`Referral milestone removed: ${result.milestoneId}`, result);
+  }
+  if (toolName === "contact.referral_rewards") {
+    const publicationId = readRequiredString(args, "publicationId");
+    const contactId = asOptionalString(args.contactId);
+    const requestedLimit = readOptionalNumber(args, "limit");
+    const limit = Math.max(1, Math.min(500, Math.trunc(requestedLimit ?? 100)));
+    const rewards = await callTrpc(
+      "contact.referralRewards",
+      {
+        publicationId,
+        ...contactId ? { contactId } : {},
+        limit
+      },
+      options,
+      "query"
+    );
+    return makeToolResult(
+      rewards.length === 0 ? `No referral rewards found for ${publicationId}` : `Loaded ${rewards.length} referral rewards for ${publicationId}`,
+      { publicationId, rewards }
+    );
+  }
+  if (toolName === "monetize.offer_list") {
+    const publicationId = readRequiredString(args, "publicationId");
+    const status = readSponsorOfferStatus(args, "status");
+    const requestedLimit = readOptionalNumber(args, "limit");
+    const limit = Math.max(1, Math.min(200, Math.trunc(requestedLimit ?? 100)));
+    const offers = await callTrpc(
+      "monetize.listOffers",
+      {
+        publicationId,
+        ...status ? { status } : {},
+        limit
+      },
+      options,
+      "query"
+    );
+    return makeToolResult(
+      offers.length === 0 ? `No sponsor offers found for ${publicationId}` : `Loaded ${offers.length} sponsor offers for ${publicationId}`,
+      { publicationId, offers }
+    );
+  }
+  if (toolName === "monetize.offer_upsert") {
+    const publicationId = readRequiredString(args, "publicationId");
+    const offerId = asOptionalString(args.offerId);
+    const title = readRequiredString(args, "title");
+    const sponsorName = readRequiredString(args, "sponsorName");
+    const description = asOptionalString(args.description);
+    const pricingModel = readSponsorOfferPricingModel(args, "pricingModel");
+    if (!pricingModel) {
+      throw new Error("pricingModel is required");
+    }
+    const rateCentsInput = readOptionalNumber(args, "rateCents");
+    if (typeof rateCentsInput !== "number" || !Number.isFinite(rateCentsInput)) {
+      throw new Error("rateCents is required and must be a number");
+    }
+    const rateCents = Math.max(1, Math.trunc(rateCentsInput));
+    const estimatedPlacementsInput = readOptionalNumber(args, "estimatedPlacements");
+    const estimatedPlacements = typeof estimatedPlacementsInput === "number" && Number.isFinite(estimatedPlacementsInput) ? Math.max(1, Math.trunc(estimatedPlacementsInput)) : void 0;
+    const status = readSponsorOfferStatus(args, "status");
+    const startsAt = asOptionalString(args.startsAt);
+    const endsAt = asOptionalString(args.endsAt);
+    const result = await callTrpc(
+      "monetize.upsertOffer",
+      {
+        publicationId,
+        ...offerId ? { offerId } : {},
+        title,
+        sponsorName,
+        ...description ? { description } : {},
+        pricingModel,
+        rateCents,
+        ...typeof estimatedPlacements === "number" ? { estimatedPlacements } : {},
+        ...status ? { status } : {},
+        ...startsAt ? { startsAt } : {},
+        ...endsAt ? { endsAt } : {}
+      },
+      options
+    );
+    return makeToolResult(`Sponsor offer saved: ${result.offer.id}`, result);
+  }
+  if (toolName === "monetize.offer_remove") {
+    const publicationId = readRequiredString(args, "publicationId");
+    const offerId = readRequiredString(args, "offerId");
+    const result = await callTrpc(
+      "monetize.removeOffer",
+      {
+        publicationId,
+        offerId
+      },
+      options
+    );
+    return makeToolResult(`Sponsor offer removed: ${result.offerId}`, result);
+  }
+  if (toolName === "section.list") {
+    const publicationId = readRequiredString(args, "publicationId");
+    const requestedLimit = readOptionalNumber(args, "limit");
+    const limit = Math.max(1, Math.min(200, Math.trunc(requestedLimit ?? 100)));
+    const rows = await callTrpc(
+      "section.list",
+      { publicationId, limit },
+      options,
+      "query"
+    );
+    return makeToolResult(
+      rows.length === 0 ? `No reusable sections found for ${publicationId}` : `Loaded ${rows.length} reusable sections for ${publicationId}`,
+      {
+        publicationId,
+        sections: rows
+      }
+    );
+  }
+  if (toolName === "section.catalog") {
+    const publicationId = asOptionalString(args.publicationId);
+    const packs = await callTrpc(
+      "section.catalog",
+      publicationId ? { publicationId } : {},
+      options,
+      "query"
+    );
+    return makeToolResult(
+      packs.length === 0 ? "No marketplace packs available" : `Loaded ${packs.length} marketplace packs`,
+      { packs }
+    );
+  }
+  if (toolName === "section.pack_create") {
+    const publicationId = readRequiredString(args, "publicationId");
+    const title = readRequiredString(args, "title");
+    const description = asOptionalString(args.description);
+    const styleProfile = readOptionalJsonObject(args, "styleProfile");
+    const sections = readRequiredPackSections(args, "sections");
+    const result = await callTrpc(
+      "section.createPack",
+      {
+        publicationId,
+        title,
+        ...description ? { description } : {},
+        ...styleProfile ? { styleProfile } : {},
+        sections
+      },
+      options
+    );
+    return makeToolResult(`Marketplace pack created: ${result.pack.id}`, result);
+  }
+  if (toolName === "section.pack_update") {
+    const publicationId = readRequiredString(args, "publicationId");
+    const packId = readRequiredString(args, "packId");
+    const title = readRequiredString(args, "title");
+    const description = asOptionalString(args.description);
+    const styleProfile = readOptionalJsonObject(args, "styleProfile");
+    const sections = readRequiredPackSections(args, "sections");
+    const result = await callTrpc(
+      "section.updatePack",
+      {
+        publicationId,
+        packId,
+        title,
+        ...description ? { description } : {},
+        ...styleProfile ? { styleProfile } : {},
+        sections
+      },
+      options
+    );
+    return makeToolResult(`Marketplace pack updated: ${result.pack.id}`, result);
+  }
+  if (toolName === "section.pack_remove") {
+    const publicationId = readRequiredString(args, "publicationId");
+    const packId = readRequiredString(args, "packId");
+    const result = await callTrpc(
+      "section.removePack",
+      {
+        publicationId,
+        packId
+      },
+      options
+    );
+    return makeToolResult(`Marketplace pack removed: ${result.packId}`, result);
+  }
+  if (toolName === "section.pack_revisions") {
+    const publicationId = readRequiredString(args, "publicationId");
+    const packId = readRequiredString(args, "packId");
+    const requestedLimit = readOptionalNumber(args, "limit");
+    const limit = Math.max(1, Math.min(100, Math.trunc(requestedLimit ?? 30)));
+    const result = await callTrpc(
+      "section.revisions",
+      {
+        publicationId,
+        packId,
+        limit
+      },
+      options,
+      "query"
+    );
+    return makeToolResult(
+      result.length === 0 ? `No revisions found for ${packId}` : `Loaded ${result.length} revisions for ${packId}`,
+      {
+        publicationId,
+        packId,
+        revisions: result
+      }
+    );
+  }
+  if (toolName === "section.pack_restore_revision") {
+    const publicationId = readRequiredString(args, "publicationId");
+    const packId = readRequiredString(args, "packId");
+    const revisionId = readRequiredString(args, "revisionId");
+    const result = await callTrpc(
+      "section.restorePackRevision",
+      {
+        publicationId,
+        packId,
+        revisionId
+      },
+      options
+    );
+    return makeToolResult(
+      `Marketplace pack restored: ${result.pack.id} (from v${result.restoredFrom.version} -> v${result.createdRevision.version})`,
+      result
+    );
+  }
+  if (toolName === "section.import_pack") {
+    const publicationId = readRequiredString(args, "publicationId");
+    const presetId = readRequiredString(args, "presetId");
+    const result = await callTrpc(
+      "section.importPack",
+      {
+        publicationId,
+        presetId
+      },
+      options
+    );
+    return makeToolResult(
+      `Imported pack ${result.presetId}: ${result.createdCount} created, ${result.updatedCount} updated`,
+      result
+    );
+  }
+  if (toolName === "section.create") {
+    const publicationId = readRequiredString(args, "publicationId");
+    const name = readRequiredString(args, "name");
+    const contentJson = readRequiredJsonObjectArray(args, "contentJson");
+    const section = await callTrpc(
+      "section.create",
+      {
+        publicationId,
+        name,
+        contentJson
+      },
+      options
+    );
+    return makeToolResult(`Reusable section saved: ${section.id}`, { section });
+  }
+  if (toolName === "section.update") {
+    const sectionId = readRequiredString(args, "sectionId");
+    const name = readRequiredString(args, "name");
+    const contentJson = readRequiredJsonObjectArray(args, "contentJson");
+    const section = await callTrpc(
+      "section.update",
+      {
+        sectionId,
+        name,
+        contentJson
+      },
+      options
+    );
+    return makeToolResult(`Reusable section updated: ${section.id}`, { section });
+  }
+  if (toolName === "section.remove") {
+    const sectionId = readRequiredString(args, "sectionId");
+    const result = await callTrpc(
+      "section.remove",
+      { sectionId },
+      options
+    );
+    return makeToolResult(`Reusable section removed: ${result.sectionId}`, result);
+  }
+  if (toolName === "issue.preview") {
+    const issueId = readRequiredString(args, "issueId");
+    const preview = await callTrpc(
+      "issue.preview",
+      { issueId },
+      options,
+      "query"
+    );
+    return makeToolResult(`Preview generated for ${preview.issueId}`, preview);
+  }
+  if (toolName === "issue.preview_draft") {
+    const publicationId = readRequiredString(args, "publicationId");
+    const title = readRequiredString(args, "title");
+    const html = readRequiredString(args, "html");
+    const plainText = asOptionalString(args.plainText);
+    const styleProfile = readOptionalJsonObject(args, "styleProfile");
+    const preview = await callTrpc(
+      "issue.previewDraft",
+      {
+        publicationId,
+        title,
+        html,
+        ...plainText ? { plainText } : {},
+        ...styleProfile ? { styleProfile } : {}
+      },
+      options
+    );
+    return makeToolResult(
+      `Draft preview generated for ${preview.publicationId}: ${preview.title}`,
+      preview
+    );
+  }
+  if (toolName === "issue.delivery_progress") {
+    const publicationId = readRequiredString(args, "publicationId");
+    const issueId = readRequiredString(args, "issueId");
+    const progress = await callTrpc(
+      "issue.deliveryProgress",
+      {
+        publicationId,
+        issueId
+      },
+      options,
+      "query"
+    );
+    if (progress.delivery.isPreparing) {
+      return makeToolResult(
+        `Issue ${progress.issueId} is preparing delivery (status: ${progress.status})`,
+        progress
+      );
+    }
+    return makeToolResult(
+      `Issue ${progress.issueId} delivery: ${progress.delivery.processed}/${progress.delivery.total} processed (${progress.delivery.completionPercent}%)`,
+      progress
+    );
+  }
+  if (toolName === "issue.wait_delivery") {
+    const publicationId = readRequiredString(args, "publicationId");
+    const issueId = readRequiredString(args, "issueId");
+    const timeoutMs = Math.max(1e3, Math.min(3e5, Math.trunc(readOptionalNumber(args, "timeoutMs") ?? 6e4)));
+    const pollIntervalMs = Math.max(250, Math.min(1e4, Math.trunc(readOptionalNumber(args, "pollIntervalMs") ?? 2e3)));
+    const startedAt = Date.now();
+    while (true) {
+      const progress = await callTrpc(
+        "issue.deliveryProgress",
+        {
+          publicationId,
+          issueId
+        },
+        options,
+        "query"
+      );
+      if (progress.status === "sent" || progress.status === "failed") {
+        return makeToolResult(
+          `Issue ${progress.issueId} delivery finished with status ${progress.status}: ${progress.delivery.processed}/${progress.delivery.total} processed (${progress.delivery.completionPercent}%)`,
+          {
+            timedOut: false,
+            elapsedMs: Date.now() - startedAt,
+            progress
+          }
+        );
+      }
+      const elapsedMs = Date.now() - startedAt;
+      if (elapsedMs >= timeoutMs) {
+        return makeToolResult(
+          `Issue ${progress.issueId} delivery still in status ${progress.status} after ${elapsedMs}ms`,
+          {
+            timedOut: true,
+            elapsedMs,
+            progress
+          }
+        );
+      }
+      await sleep(pollIntervalMs);
+    }
+  }
+  if (toolName === "analytics.poll_results") {
+    const publicationId = readRequiredString(args, "publicationId");
+    const issueId = readRequiredString(args, "issueId");
+    const analytics = await callTrpc(
+      "issue.pollResults",
+      {
+        publicationId,
+        issueId
+      },
+      options,
+      "query"
+    );
+    return makeToolResult(
+      analytics.polls.length === 0 ? `No poll results yet for ${issueId}` : `Loaded ${analytics.polls.length} polls for ${issueId}`,
+      analytics
+    );
+  }
+  if (toolName === "analytics.issue_performance") {
+    const publicationId = readRequiredString(args, "publicationId");
+    const issueId = readRequiredString(args, "issueId");
+    const range = readIssueAnalyticsRange(args, "range") ?? "all";
+    const analytics = await callTrpc(
+      "issue.analytics",
+      {
+        publicationId,
+        issueId,
+        range
+      },
+      options,
+      "query"
+    );
+    return makeToolResult(
+      `Issue analytics loaded for ${issueId}: ${analytics.opens.unique} unique opens, ${analytics.clicks.unique} unique clicks`,
+      analytics
+    );
+  }
+  if (toolName === "analytics.issue_export_csv") {
+    const publicationId = readRequiredString(args, "publicationId");
+    const issueId = readRequiredString(args, "issueId");
+    const range = readIssueAnalyticsRange(args, "range") ?? "all";
+    const exportType = readIssueAnalyticsExportType(args, "exportType") ?? "combined";
+    const exported = await callTrpc(
+      "issue.analyticsExportCsv",
+      {
+        publicationId,
+        issueId,
+        range,
+        exportType
+      },
+      options,
+      "query"
+    );
+    return makeToolResult(
+      `Issue analytics ${exported.exportType} CSV ready for ${issueId}: ${exported.filename} (${exported.rowCount} rows)`,
+      exported
+    );
+  }
+  if (toolName === "analytics.issue_export_performance_csv") {
+    const publicationId = readRequiredString(args, "publicationId");
+    const issueId = readRequiredString(args, "issueId");
+    const range = readIssueAnalyticsRange(args, "range") ?? "all";
+    const exported = await callTrpc(
+      "issue.analyticsExportCsv",
+      {
+        publicationId,
+        issueId,
+        range,
+        exportType: "performance"
+      },
+      options,
+      "query"
+    );
+    return makeToolResult(
+      `Issue performance CSV ready for ${issueId}: ${exported.filename} (${exported.rowCount} rows)`,
+      exported
+    );
+  }
+  if (toolName === "analytics.issue_export_polls_csv") {
+    const publicationId = readRequiredString(args, "publicationId");
+    const issueId = readRequiredString(args, "issueId");
+    const range = readIssueAnalyticsRange(args, "range") ?? "all";
+    const exported = await callTrpc(
+      "issue.analyticsExportCsv",
+      {
+        publicationId,
+        issueId,
+        range,
+        exportType: "polls"
+      },
+      options,
+      "query"
+    );
+    return makeToolResult(
+      `Issue poll CSV ready for ${issueId}: ${exported.filename} (${exported.rowCount} rows)`,
+      exported
+    );
+  }
+  if (toolName === "analytics.issue_trend") {
+    const publicationId = readRequiredString(args, "publicationId");
+    const issueId = readRequiredString(args, "issueId");
+    const range = readIssueAnalyticsRange(args, "range") ?? "all";
+    const trend = await callTrpc(
+      "issue.analyticsTrend",
+      {
+        publicationId,
+        issueId,
+        range
+      },
+      options,
+      "query"
+    );
+    return makeToolResult(
+      `Issue trend loaded for ${issueId}: ${trend.points.length} daily points`,
+      trend
+    );
+  }
+  if (toolName === "analytics.latest_summary") {
+    const publicationId = asOptionalString(args.publicationId);
+    const range = readIssueAnalyticsRange(args, "range") ?? "7d";
+    const summary = await loadLatestAnalyticsSummary(options, {
+      publicationId,
+      range
+    });
+    if (summary.status === "missing_publication_context") {
+      return makeToolResult("Missing publication context for analytics.latest_summary", summary);
+    }
+    if (summary.status === "no_issues") {
+      return makeToolResult(`No issues found for ${summary.publicationId}`, summary);
+    }
+    return makeToolResult(
+      `Latest analytics loaded for ${summary.issue.id}: ${summary.analytics.opens.unique} unique opens, ${summary.analytics.clicks.unique} unique clicks`,
+      summary
+    );
+  }
+  if (toolName === "issue.schedule") {
+    const issueId = readRequiredString(args, "issueId");
+    const scheduledFor = asOptionalString(args.scheduledFor);
+    const issue = await callTrpc(
+      "issue.schedule",
+      {
+        issueId,
+        ...scheduledFor ? { scheduledFor } : {}
+      },
+      options
+    );
+    return makeToolResult(`Issue scheduled: ${issue.id}`, { issue });
+  }
+  if (toolName === "issue.unschedule") {
+    const issueId = readRequiredString(args, "issueId");
+    const issue = await callTrpc(
+      "issue.unschedule",
+      { issueId },
+      options
+    );
+    return makeToolResult(`Issue unscheduled: ${issue.id}`, { issue });
+  }
+  if (toolName === "issue.publish_to_web") {
+    const issueId = readRequiredString(args, "issueId");
+    const issue = await callTrpc(
+      "issue.publishToWeb",
+      { issueId },
+      options
+    );
+    return makeToolResult(`Issue published to web: ${issue.id}`, { issue });
+  }
+  if (toolName === "issue.unpublish_from_web") {
+    const issueId = readRequiredString(args, "issueId");
+    const issue = await callTrpc(
+      "issue.unpublishFromWeb",
+      { issueId },
+      options
+    );
+    return makeToolResult(`Issue unpublished from web: ${issue.id}`, { issue });
+  }
+  if (toolName === "issue.send_now") {
+    const issueId = readRequiredString(args, "issueId");
+    const issue = await callTrpc(
+      "issue.sendNow",
+      { issueId },
+      options
+    );
+    return makeToolResult(`Issue sent: ${issue.id}`, { issue });
+  }
+  if (toolName === "issue.send_and_wait") {
+    const issueId = readRequiredString(args, "issueId");
+    const timeoutMs = Math.max(1e3, Math.min(3e5, Math.trunc(readOptionalNumber(args, "timeoutMs") ?? 6e4)));
+    const pollIntervalMs = Math.max(250, Math.min(1e4, Math.trunc(readOptionalNumber(args, "pollIntervalMs") ?? 2e3)));
+    const issue = await callTrpc(
+      "issue.sendNow",
+      { issueId },
+      options
+    );
+    const startedAt = Date.now();
+    while (true) {
+      const progress = await callTrpc(
+        "issue.deliveryProgress",
+        {
+          publicationId: issue.publicationId,
+          issueId: issue.id
+        },
+        options,
+        "query"
+      );
+      if (progress.status === "sent" || progress.status === "failed") {
+        return makeToolResult(
+          `Issue ${issue.id} send-and-wait finished with status ${progress.status}: ${progress.delivery.processed}/${progress.delivery.total} processed (${progress.delivery.completionPercent}%)`,
+          {
+            issue,
+            timedOut: false,
+            elapsedMs: Date.now() - startedAt,
+            progress
+          }
+        );
+      }
+      const elapsedMs = Date.now() - startedAt;
+      if (elapsedMs >= timeoutMs) {
+        return makeToolResult(
+          `Issue ${issue.id} queued but still ${progress.status} after ${elapsedMs}ms`,
+          {
+            issue,
+            timedOut: true,
+            elapsedMs,
+            progress
+          }
+        );
+      }
+      await sleep(pollIntervalMs);
+    }
+  }
+  if (toolName === "ai.generate_draft") {
+    const publicationId = readRequiredString(args, "publicationId");
+    const prompt = readRequiredString(args, "prompt");
+    const tone = asOptionalString(args.tone);
+    if (tone && tone !== "neutral" && tone !== "friendly" && tone !== "formal") {
+      throw new Error("tone must be one of: neutral, friendly, formal");
+    }
+    const draft = await callTrpc(
+      "ai.generateDraft",
+      {
+        publicationId,
+        prompt,
+        ...tone ? { tone } : {}
+      },
+      options
+    );
+    return makeToolResult("AI draft generated", draft);
+  }
+  if (toolName === "template.create") {
+    const publicationId = readRequiredString(args, "publicationId");
+    const name = readRequiredString(args, "name");
+    const html = asOptionalString(args.html);
+    const spec = args.spec;
+    const description = asOptionalString(args.description);
+    const subject = asOptionalString(args.subject);
+    const variables = args.variables;
+    if (!html && !spec) {
+      throw new Error("Either 'html' or 'spec' must be provided");
+    }
+    const body = {
+      publication_id: publicationId,
+      name,
+      ...html ? { html } : {},
+      ...spec ? { spec } : {},
+      ...description ? { description } : {},
+      ...subject ? { subject } : {},
+      ...variables ? { variables } : {}
+    };
+    const template = await callRestApi(
+      "POST",
+      "/v1/templates",
+      body,
+      options
+    );
+    return makeToolResult(
+      `Template created: ${template.id} (${template.format})`,
+      { template }
+    );
+  }
+  if (toolName === "template.list") {
+    const publicationId = readRequiredString(args, "publicationId");
+    const limit = readOptionalNumber(args, "limit") ?? 20;
+    const result = await callRestApi(
+      "GET",
+      `/v1/templates?publication_id=${encodeURIComponent(publicationId)}&limit=${limit}`,
+      void 0,
+      options
+    );
+    const names = result.data.map((t) => `${t.id}: ${t.name} (${t.format}, ${t.status})`);
+    return makeToolResult(
+      result.data.length > 0 ? `${result.data.length} template(s):
+${names.join("\n")}` : "No templates found",
+      result
+    );
+  }
+  if (toolName === "template.get") {
+    const publicationId = readRequiredString(args, "publicationId");
+    const templateId = readRequiredString(args, "templateId");
+    const template = await callRestApi(
+      "GET",
+      `/v1/templates/${encodeURIComponent(templateId)}?publication_id=${encodeURIComponent(publicationId)}`,
+      void 0,
+      options
+    );
+    return makeToolResult(
+      `Template: ${template.name} (${template.format}, ${template.status})`,
+      { template }
+    );
+  }
+  if (toolName === "template.update") {
+    const publicationId = readRequiredString(args, "publicationId");
+    const templateId = readRequiredString(args, "templateId");
+    const name = asOptionalString(args.name);
+    const html = asOptionalString(args.html);
+    const spec = args.spec;
+    const description = asOptionalString(args.description);
+    const text = asOptionalString(args.text);
+    const subject = asOptionalString(args.subject);
+    const from = asOptionalString(args.from);
+    const replyTo = asOptionalString(args.reply_to);
+    const variables = args.variables;
+    const body = {
+      ...name ? { name } : {},
+      ...html ? { html } : {},
+      ...spec ? { spec } : {},
+      ...description ? { description } : {},
+      ...text ? { text } : {},
+      ...subject ? { subject } : {},
+      ...from ? { from } : {},
+      ...replyTo ? { reply_to: replyTo } : {},
+      ...variables ? { variables } : {}
+    };
+    const template = await callRestApi(
+      "PATCH",
+      `/v1/templates/${encodeURIComponent(templateId)}?publication_id=${encodeURIComponent(publicationId)}`,
+      body,
+      options
+    );
+    return makeToolResult(`Template updated: ${template.id}`, { template });
+  }
+  if (toolName === "template.publish") {
+    const publicationId = readRequiredString(args, "publicationId");
+    const templateId = readRequiredString(args, "templateId");
+    const template = await callRestApi(
+      "POST",
+      `/v1/templates/${encodeURIComponent(templateId)}/publish?publication_id=${encodeURIComponent(publicationId)}`,
+      void 0,
+      options
+    );
+    return makeToolResult(`Template published: ${template.id} (${template.status})`, { template });
+  }
+  if (toolName === "template.duplicate") {
+    const publicationId = readRequiredString(args, "publicationId");
+    const templateId = readRequiredString(args, "templateId");
+    const template = await callRestApi(
+      "POST",
+      `/v1/templates/${encodeURIComponent(templateId)}/duplicate?publication_id=${encodeURIComponent(publicationId)}`,
+      void 0,
+      options
+    );
+    return makeToolResult(`Template duplicated: new template ${template.id}`, { template });
+  }
+  if (toolName === "template.delete") {
+    const publicationId = readRequiredString(args, "publicationId");
+    const templateId = readRequiredString(args, "templateId");
+    const result = await callRestApi(
+      "DELETE",
+      `/v1/templates/${encodeURIComponent(templateId)}?publication_id=${encodeURIComponent(publicationId)}`,
+      void 0,
+      options
+    );
+    return makeToolResult(`Template deleted: ${result.id}`, result);
+  }
+  if (toolName === "email.send") {
+    const body = {};
+    for (const key of EMAIL_SEND_FIELDS) {
+      if (args[key] !== void 0) body[key] = args[key];
+    }
+    for (const required of ["from", "to", "subject"]) {
+      if (body[required] === void 0) {
+        throw new Error(`Missing required field: ${required}`);
+      }
+    }
+    const result = await callRestApi(
+      "POST",
+      "/v1/emails",
+      body,
+      options
+    );
+    return makeToolResult(
+      body.scheduled_at ? `Email scheduled (${result.id}) for ${String(body.scheduled_at)}` : `Email queued for delivery (${result.id})`,
+      result
+    );
+  }
+  if (toolName === "email.batch") {
+    const emails = args.emails;
+    if (!Array.isArray(emails) || emails.length === 0) {
+      throw new Error("'emails' must be a non-empty array of email objects.");
+    }
+    const result = await callRestApi(
+      "POST",
+      "/v1/emails/batch",
+      emails,
+      options
+    );
+    return makeToolResult(
+      `Batch queued: ${result.data?.length ?? 0} email(s).`,
+      result
+    );
+  }
+  if (toolName === "email.get") {
+    const id = readRequiredString(args, "id");
+    const email = await callRestApi(
+      "GET",
+      `/v1/emails/${encodeURIComponent(id)}`,
+      void 0,
+      options
+    );
+    return makeToolResult(
+      `Email ${id}: ${String(email.last_event ?? "unknown")} (opens ${String(
+        email.open_count ?? 0
+      )}, clicks ${String(email.click_count ?? 0)})`,
+      { email }
+    );
+  }
+  if (toolName === "email.reschedule") {
+    const id = readRequiredString(args, "id");
+    const scheduledAt = readRequiredString(args, "scheduled_at");
+    const result = await callRestApi(
+      "PATCH",
+      `/v1/emails/${encodeURIComponent(id)}`,
+      { scheduled_at: scheduledAt },
+      options
+    );
+    return makeToolResult(`Email ${id} rescheduled for ${scheduledAt}.`, result);
+  }
+  if (toolName === "email.cancel") {
+    const id = readRequiredString(args, "id");
+    const result = await callRestApi(
+      "POST",
+      `/v1/emails/${encodeURIComponent(id)}/cancel`,
+      void 0,
+      options
+    );
+    return makeToolResult(`Email ${id} canceled.`, result);
+  }
+  if (toolName === "email.resend") {
+    const id = readRequiredString(args, "id");
+    const result = await callTrpc(
+      "email.resend",
+      { id },
+      options
+    );
+    return makeToolResult(`Email ${id} resent as ${result.email.id}.`, result);
+  }
+  if (toolName === "email.list") {
+    const params = new URLSearchParams();
+    const limit = readOptionalNumber(args, "limit");
+    const offset = readOptionalNumber(args, "offset");
+    if (limit !== void 0) params.set("limit", String(limit));
+    if (offset !== void 0) params.set("offset", String(offset));
+    for (const key of ["status", "tag_name", "tag_value", "from_date", "to_date"]) {
+      const value = asOptionalString(args[key]);
+      if (value) params.set(key, value);
+    }
+    const qs = params.toString();
+    const result = await callRestApi("GET", `/v1/emails${qs ? `?${qs}` : ""}`, void 0, options);
+    const lines = result.data.map(
+      (email) => `${String(email.id)}: ${String(email.last_event)} \u2014 ${String(email.subject)} \u2192 ${String(email.to)}`
+    );
+    return makeToolResult(
+      result.data.length > 0 ? `${result.data.length} of ${result.total} email(s):
+${lines.join("\n")}` : "No emails found.",
+      result
+    );
+  }
+  if (toolName === "email.analytics") {
+    const params = new URLSearchParams();
+    for (const key of ["from_date", "to_date"]) {
+      const value = asOptionalString(args[key]);
+      if (value) params.set(key, value);
+    }
+    const qs = params.toString();
+    const result = await callRestApi("GET", `/v1/emails/analytics${qs ? `?${qs}` : ""}`, void 0, options);
+    const pct = (rate) => `${(rate * 100).toFixed(1)}%`;
+    return makeToolResult(
+      `${result.sent} sent (of ${result.total}): delivered ${result.delivered} (${pct(result.rates.delivery_rate)}), opened ${result.opened} (${pct(result.rates.open_rate)}), clicked ${result.clicked} (${pct(result.rates.click_rate)}), bounced ${result.bounced} (${pct(result.rates.bounce_rate)})`,
+      result
+    );
+  }
+  if (toolName === "email.inbound_list") {
+    const publicationId = readRequiredString(args, "publicationId");
+    const limit = readOptionalNumber(args, "limit");
+    const cursor = asOptionalString(args.cursor);
+    const params = new URLSearchParams({ publication_id: publicationId });
+    if (limit !== void 0) params.set("limit", String(limit));
+    if (cursor) params.set("cursor", cursor);
+    const result = await callRestApi(
+      "GET",
+      `/v1/emails/inbound?${params.toString()}`,
+      void 0,
+      options
+    );
+    return makeToolResult(`${result.data.length} inbound email(s).`, result);
+  }
+  if (toolName === "email.inbound_get") {
+    const id = readRequiredString(args, "id");
+    const result = await callRestApi(
+      "GET",
+      `/v1/emails/inbound/${encodeURIComponent(id)}`,
+      void 0,
+      options
+    );
+    return makeToolResult(
+      `Inbound email ${id}: ${String(result.subject ?? "(no subject)")} from ${String(
+        result.from ?? "unknown"
+      )}.`,
+      result
+    );
+  }
+  if (toolName === "email.inbound_list_attachments") {
+    const id = readRequiredString(args, "id");
+    const result = await callRestApi(
+      "GET",
+      `/v1/emails/inbound/${encodeURIComponent(id)}/attachments`,
+      void 0,
+      options
+    );
+    return makeToolResult(`${result.data.length} attachment(s).`, result);
+  }
+  if (toolName === "email.inbound_get_attachment") {
+    const id = readRequiredString(args, "id");
+    const attachmentId = readRequiredString(args, "attachmentId");
+    const result = await callRestApi(
+      "GET",
+      `/v1/emails/inbound/${encodeURIComponent(id)}/attachments/${encodeURIComponent(attachmentId)}`,
+      void 0,
+      options
+    );
+    return makeToolResult(`Attachment ${result.id} (${result.filename}).`, result);
+  }
+  if (toolName === "email.inbound_reply") {
+    const id = readRequiredString(args, "id");
+    const body = {};
+    for (const key of ["from", "subject", "html", "text", "cc", "bcc", "idempotency_key"]) {
+      if (args[key] !== void 0) body[key] = args[key];
+    }
+    if (body.html === void 0 && body.text === void 0) {
+      throw new Error("Provide 'html' and/or 'text' for the reply body.");
+    }
+    const result = await callRestApi(
+      "POST",
+      `/v1/emails/inbound/${encodeURIComponent(id)}/reply`,
+      body,
+      options
+    );
+    return makeToolResult(`Reply queued as ${result.id} (${result.status}).`, result);
+  }
+  if (toolName === "issue.send_test") {
+    const issueId = readRequiredString(args, "issueId");
+    const from = readRequiredString(args, "from");
+    const recipients = args.recipients;
+    if (!recipients || typeof recipients !== "string" && !Array.isArray(recipients) || Array.isArray(recipients) && recipients.length === 0) {
+      throw new Error("'recipients' must be an email address or a non-empty array of addresses.");
+    }
+    const recipientList = Array.isArray(recipients) ? recipients : [recipients];
+    const result = await callRestApi(
+      "POST",
+      `/v1/posts/${encodeURIComponent(issueId)}/test`,
+      { recipients: recipientList, from },
+      options
+    );
+    const failedNote = result.failed_to.length ? `, ${result.failed_to.length} failed` : "";
+    return makeToolResult(
+      `Test of ${issueId} sent to ${result.sent_to.length} recipient(s)${failedNote}.`,
+      result
+    );
+  }
+  if (toolName === "domain.create") {
+    const publicationId = readRequiredString(args, "publicationId");
+    const name = readRequiredString(args, "name");
+    const purpose = asOptionalString(args.purpose);
+    const isPrimary = readOptionalBoolean(args, "is_primary");
+    const result = await callRestApi(
+      "POST",
+      "/v1/domains",
+      {
+        publication_id: publicationId,
+        name,
+        ...purpose ? { purpose } : {},
+        ...isPrimary !== void 0 ? { is_primary: isPrimary } : {}
+      },
+      options
+    );
+    return makeToolResult(
+      `Domain ${result.name} created (${result.status}). Add the DNS records, then call domain.verify.`,
+      result
+    );
+  }
+  if (toolName === "domain.list") {
+    const publicationId = readRequiredString(args, "publicationId");
+    const limit = readOptionalNumber(args, "limit");
+    const params = new URLSearchParams({ publication_id: publicationId });
+    if (limit !== void 0) params.set("limit", String(limit));
+    const result = await callRestApi(
+      "GET",
+      `/v1/domains?${params.toString()}`,
+      void 0,
+      options
+    );
+    return makeToolResult(`${result.data.length} domain(s).`, result);
+  }
+  if (toolName === "domain.get") {
+    const publicationId = readRequiredString(args, "publicationId");
+    const domainId = readRequiredString(args, "domainId");
+    const result = await callRestApi(
+      "GET",
+      `/v1/domains/${encodeURIComponent(domainId)}?publication_id=${encodeURIComponent(publicationId)}`,
+      void 0,
+      options
+    );
+    return makeToolResult(`Domain ${result.name} (${result.status}).`, result);
+  }
+  if (toolName === "domain.verify") {
+    const publicationId = readRequiredString(args, "publicationId");
+    const domainId = readRequiredString(args, "domainId");
+    const result = await callRestApi(
+      "POST",
+      `/v1/domains/${encodeURIComponent(domainId)}/verify?publication_id=${encodeURIComponent(publicationId)}`,
+      void 0,
+      options
+    );
+    return makeToolResult(`Domain ${result.name} is now ${result.status}.`, result);
+  }
+  if (toolName === "domain.update") {
+    const publicationId = readRequiredString(args, "publicationId");
+    const domainId = readRequiredString(args, "domainId");
+    const purpose = asOptionalString(args.purpose);
+    const isPrimary = readOptionalBoolean(args, "is_primary");
+    const result = await callRestApi(
+      "PATCH",
+      `/v1/domains/${encodeURIComponent(domainId)}?publication_id=${encodeURIComponent(publicationId)}`,
+      {
+        ...purpose ? { purpose } : {},
+        ...isPrimary !== void 0 ? { is_primary: isPrimary } : {}
+      },
+      options
+    );
+    return makeToolResult(`Domain ${result.name} updated (purpose: ${result.purpose}).`, result);
+  }
+  if (toolName === "domain.delete") {
+    const publicationId = readRequiredString(args, "publicationId");
+    const domainId = readRequiredString(args, "domainId");
+    const result = await callRestApi(
+      "DELETE",
+      `/v1/domains/${encodeURIComponent(domainId)}?publication_id=${encodeURIComponent(publicationId)}`,
+      void 0,
+      options
+    );
+    return makeToolResult(`Domain ${result.id} deleted.`, result);
+  }
+  if (toolName === "domain.tracking_create") {
+    const publicationId = readRequiredString(args, "publicationId");
+    const domainId = readRequiredString(args, "domainId");
+    const subdomain = readRequiredString(args, "subdomain");
+    const result = await callRestApi(
+      "POST",
+      `/v1/domains/${encodeURIComponent(domainId)}/tracking-domains?publication_id=${encodeURIComponent(publicationId)}`,
+      { subdomain },
+      options
+    );
+    return makeToolResult(
+      `Tracking domain ${result.full_name} created (${result.status}). Add the CNAME record, then call domain.tracking_verify.`,
+      result
+    );
+  }
+  if (toolName === "domain.tracking_list") {
+    const publicationId = readRequiredString(args, "publicationId");
+    const domainId = readRequiredString(args, "domainId");
+    const result = await callRestApi(
+      "GET",
+      `/v1/domains/${encodeURIComponent(domainId)}/tracking-domains?publication_id=${encodeURIComponent(publicationId)}`,
+      void 0,
+      options
+    );
+    return makeToolResult(`${result.data.length} tracking domain(s).`, result);
+  }
+  if (toolName === "domain.tracking_verify") {
+    const publicationId = readRequiredString(args, "publicationId");
+    const domainId = readRequiredString(args, "domainId");
+    const trackingDomainId = readRequiredString(args, "trackingDomainId");
+    const result = await callRestApi(
+      "POST",
+      `/v1/domains/${encodeURIComponent(domainId)}/tracking-domains/${encodeURIComponent(trackingDomainId)}/verify?publication_id=${encodeURIComponent(publicationId)}`,
+      void 0,
+      options
+    );
+    return makeToolResult(`Tracking domain ${result.full_name} is now ${result.status}.`, result);
+  }
+  if (toolName === "domain.tracking_delete") {
+    const publicationId = readRequiredString(args, "publicationId");
+    const domainId = readRequiredString(args, "domainId");
+    const trackingDomainId = readRequiredString(args, "trackingDomainId");
+    const result = await callRestApi(
+      "DELETE",
+      `/v1/domains/${encodeURIComponent(domainId)}/tracking-domains/${encodeURIComponent(trackingDomainId)}?publication_id=${encodeURIComponent(publicationId)}`,
+      void 0,
+      options
+    );
+    return makeToolResult(`Tracking domain ${result.id} deleted.`, result);
+  }
+  if (toolName === "webhook.create") {
+    const publicationId = readRequiredString(args, "publicationId");
+    const endpoint = readRequiredString(args, "endpoint");
+    const events = args.events;
+    if (!Array.isArray(events) || events.length === 0 || !events.every((e) => typeof e === "string")) {
+      throw new Error("'events' must be a non-empty array of event-type strings.");
+    }
+    const result = await callRestApi(
+      "POST",
+      "/v1/webhooks/endpoints",
+      { publication_id: publicationId, endpoint, events },
+      options
+    );
+    return makeToolResult(
+      `Webhook ${result.id} created for ${result.endpoint}. Store the signing_secret now \u2014 it won't be shown again.`,
+      result
+    );
+  }
+  if (toolName === "webhook.list") {
+    const publicationId = readRequiredString(args, "publicationId");
+    const limit = readOptionalNumber(args, "limit");
+    const params = new URLSearchParams({ publication_id: publicationId });
+    if (limit !== void 0) params.set("limit", String(limit));
+    const result = await callRestApi(
+      "GET",
+      `/v1/webhooks/endpoints?${params.toString()}`,
+      void 0,
+      options
+    );
+    return makeToolResult(`${result.data.length} webhook(s).`, result);
+  }
+  if (toolName === "webhook.get") {
+    const publicationId = readRequiredString(args, "publicationId");
+    const webhookId = readRequiredString(args, "webhookId");
+    const result = await callRestApi(
+      "GET",
+      `/v1/webhooks/endpoints/${encodeURIComponent(webhookId)}?publication_id=${encodeURIComponent(publicationId)}`,
+      void 0,
+      options
+    );
+    return makeToolResult(`Webhook ${result.id} (${result.status}) -> ${result.endpoint}.`, result);
+  }
+  if (toolName === "webhook.update") {
+    const publicationId = readRequiredString(args, "publicationId");
+    const webhookId = readRequiredString(args, "webhookId");
+    const endpoint = asOptionalString(args.endpoint);
+    const status = asOptionalString(args.status);
+    const events = args.events;
+    if (events !== void 0 && (!Array.isArray(events) || !events.every((e) => typeof e === "string"))) {
+      throw new Error("'events' must be an array of event-type strings.");
+    }
+    const result = await callRestApi(
+      "PATCH",
+      `/v1/webhooks/endpoints/${encodeURIComponent(webhookId)}?publication_id=${encodeURIComponent(publicationId)}`,
+      {
+        ...endpoint ? { endpoint } : {},
+        ...events !== void 0 ? { events } : {},
+        ...status ? { status } : {}
+      },
+      options
+    );
+    return makeToolResult(`Webhook ${result.id} updated (${result.status}).`, result);
+  }
+  if (toolName === "webhook.delete") {
+    const publicationId = readRequiredString(args, "publicationId");
+    const webhookId = readRequiredString(args, "webhookId");
+    const result = await callRestApi(
+      "DELETE",
+      `/v1/webhooks/endpoints/${encodeURIComponent(webhookId)}?publication_id=${encodeURIComponent(publicationId)}`,
+      void 0,
+      options
+    );
+    return makeToolResult(`Webhook ${result.id} deleted.`, result);
+  }
+  if (toolName === "segment.create") {
+    const publicationId = readRequiredString(args, "publicationId");
+    const name = readRequiredString(args, "name");
+    const description = asOptionalString(args.description);
+    const statusFilter = asOptionalString(args.status_filter);
+    const queryFilter = asOptionalString(args.query_filter);
+    const result = await callRestApi(
+      "POST",
+      "/v1/segments",
+      {
+        publication_id: publicationId,
+        name,
+        ...description !== void 0 ? { description } : {},
+        ...statusFilter ? { status_filter: statusFilter } : {},
+        ...queryFilter !== void 0 ? { query_filter: queryFilter } : {}
+      },
+      options
+    );
+    return makeToolResult(`Segment ${result.name} created (${result.id}).`, result);
+  }
+  if (toolName === "segment.list") {
+    const publicationId = readRequiredString(args, "publicationId");
+    const limit = readOptionalNumber(args, "limit");
+    const params = new URLSearchParams({ publication_id: publicationId });
+    if (limit !== void 0) params.set("limit", String(limit));
+    const result = await callRestApi(
+      "GET",
+      `/v1/segments?${params.toString()}`,
+      void 0,
+      options
+    );
+    return makeToolResult(`${result.data.length} segment(s).`, result);
+  }
+  if (toolName === "segment.get") {
+    const publicationId = readRequiredString(args, "publicationId");
+    const segmentId = readRequiredString(args, "segmentId");
+    const result = await callRestApi(
+      "GET",
+      `/v1/segments/${encodeURIComponent(segmentId)}?publication_id=${encodeURIComponent(publicationId)}`,
+      void 0,
+      options
+    );
+    return makeToolResult(`Segment ${result.name} (${result.id}).`, result);
+  }
+  if (toolName === "segment.update") {
+    const publicationId = readRequiredString(args, "publicationId");
+    const segmentId = readRequiredString(args, "segmentId");
+    const name = asOptionalString(args.name);
+    const description = asOptionalString(args.description);
+    const result = await callRestApi(
+      "PATCH",
+      `/v1/segments/${encodeURIComponent(segmentId)}?publication_id=${encodeURIComponent(publicationId)}`,
+      {
+        ...name ? { name } : {},
+        ...description !== void 0 ? { description } : {},
+        // status_filter / query_filter are nullable: forward an explicit null
+        // to CLEAR the filter, a value to set it, and omit the key entirely
+        // (absent from args) to leave it unchanged.
+        ..."status_filter" in args ? { status_filter: args.status_filter } : {},
+        ..."query_filter" in args ? { query_filter: args.query_filter } : {}
+      },
+      options
+    );
+    return makeToolResult(`Segment ${result.id} updated.`, result);
+  }
+  if (toolName === "segment.delete") {
+    const publicationId = readRequiredString(args, "publicationId");
+    const segmentId = readRequiredString(args, "segmentId");
+    const result = await callRestApi(
+      "DELETE",
+      `/v1/segments/${encodeURIComponent(segmentId)}?publication_id=${encodeURIComponent(publicationId)}`,
+      void 0,
+      options
+    );
+    return makeToolResult(`Segment ${result.id} deleted.`, result);
+  }
+  if (toolName === "contact_property.create") {
+    const key = readRequiredString(args, "key");
+    const type = asOptionalString(args.type);
+    if (type !== "string" && type !== "number") {
+      throw new Error("'type' must be 'string' or 'number'.");
+    }
+    const description = asOptionalString(args.description);
+    const fallback = args.fallback_value;
+    const result = await callRestApi(
+      "POST",
+      "/v1/contact-properties",
+      {
+        key,
+        type,
+        ...fallback !== void 0 ? { fallback_value: fallback } : {},
+        ...description !== void 0 ? { description } : {}
+      },
+      options
+    );
+    return makeToolResult(`Contact property ${result.key} created (${result.id}).`, result);
+  }
+  if (toolName === "contact_property.list") {
+    const limit = readOptionalNumber(args, "limit");
+    const qs = limit !== void 0 ? `?limit=${limit}` : "";
+    const result = await callRestApi(
+      "GET",
+      `/v1/contact-properties${qs}`,
+      void 0,
+      options
+    );
+    return makeToolResult(`${result.data.length} contact propert(ies).`, result);
+  }
+  if (toolName === "contact_property.update") {
+    const propertyId = readRequiredString(args, "propertyId");
+    const description = asOptionalString(args.description);
+    const fallback = args.fallback_value;
+    const result = await callRestApi(
+      "PATCH",
+      `/v1/contact-properties/${encodeURIComponent(propertyId)}`,
+      {
+        ...fallback !== void 0 ? { fallback_value: fallback } : {},
+        ...description !== void 0 ? { description } : {}
+      },
+      options
+    );
+    return makeToolResult(`Contact property ${result.id} updated.`, result);
+  }
+  if (toolName === "contact_property.delete") {
+    const propertyId = readRequiredString(args, "propertyId");
+    const result = await callRestApi(
+      "DELETE",
+      `/v1/contact-properties/${encodeURIComponent(propertyId)}`,
+      void 0,
+      options
+    );
+    return makeToolResult(`Contact property ${result.id} deleted.`, result);
+  }
+  if (toolName === "contact.get") {
+    const publicationId = readRequiredString(args, "publicationId");
+    const idOrEmail = readRequiredString(args, "idOrEmail");
+    const result = await callRestApi(
+      "GET",
+      `/v1/contacts/${encodeURIComponent(idOrEmail)}?publication_id=${encodeURIComponent(publicationId)}`,
+      void 0,
+      options
+    );
+    return makeToolResult(`Contact ${result.email} (${result.status}).`, result);
+  }
+  if (toolName === "contact.delete") {
+    const publicationId = readRequiredString(args, "publicationId");
+    const idOrEmail = readRequiredString(args, "idOrEmail");
+    const result = await callRestApi(
+      "DELETE",
+      `/v1/contacts/${encodeURIComponent(idOrEmail)}?publication_id=${encodeURIComponent(publicationId)}`,
+      void 0,
+      options
+    );
+    return makeToolResult(`Contact ${result.id} deleted.`, result);
+  }
+  if (toolName === "contact.get_properties") {
+    const publicationId = readRequiredString(args, "publicationId");
+    const contactId = readRequiredString(args, "contactId");
+    const result = await callTrpc(
+      "contact.getPropertyValues",
+      { publicationId, contactId },
+      options,
+      "query"
+    );
+    return makeToolResult(`Property values for contact ${contactId}.`, result);
+  }
+  if (toolName === "contact.set_properties") {
+    const publicationId = readRequiredString(args, "publicationId");
+    const contactId = readRequiredString(args, "contactId");
+    const values = args.values;
+    if (!Array.isArray(values) || values.length === 0) {
+      throw new Error("'values' must be a non-empty array of { propertyId, value }.");
+    }
+    const result = await callTrpc(
+      "contact.setPropertyValues",
+      { publicationId, contactId, values },
+      options,
+      "mutation"
+    );
+    return makeToolResult(
+      `Set ${values.length} property value(s) for contact ${contactId}.`,
+      result
+    );
+  }
+  if (toolName === "tag.create") {
+    const publicationId = readRequiredString(args, "publicationId");
+    const name = readRequiredString(args, "name");
+    const defaultSubscription = asOptionalString(args.default_subscription);
+    if (defaultSubscription !== "opt_in" && defaultSubscription !== "opt_out") {
+      throw new Error("'default_subscription' must be 'opt_in' or 'opt_out'.");
+    }
+    const description = asOptionalString(args.description);
+    const visibility = asOptionalString(args.visibility);
+    const result = await callRestApi(
+      "POST",
+      "/v1/tags",
+      {
+        publication_id: publicationId,
+        name,
+        default_subscription: defaultSubscription,
+        ...description !== void 0 ? { description } : {},
+        ...visibility ? { visibility } : {}
+      },
+      options
+    );
+    return makeToolResult(`Tag ${result.name} created (${result.id}).`, result);
+  }
+  if (toolName === "tag.list") {
+    const publicationId = readRequiredString(args, "publicationId");
+    const limit = readOptionalNumber(args, "limit");
+    const params = new URLSearchParams({ publication_id: publicationId });
+    if (limit !== void 0) params.set("limit", String(limit));
+    const result = await callRestApi(
+      "GET",
+      `/v1/tags?${params.toString()}`,
+      void 0,
+      options
+    );
+    return makeToolResult(`${result.data.length} tag(s).`, result);
+  }
+  if (toolName === "tag.update") {
+    const publicationId = readRequiredString(args, "publicationId");
+    const tagId = readRequiredString(args, "tagId");
+    const name = asOptionalString(args.name);
+    const description = asOptionalString(args.description);
+    const defaultSubscription = asOptionalString(args.default_subscription);
+    const visibility = asOptionalString(args.visibility);
+    const result = await callRestApi(
+      "PATCH",
+      `/v1/tags/${encodeURIComponent(tagId)}?publication_id=${encodeURIComponent(publicationId)}`,
+      {
+        ...name ? { name } : {},
+        ...description !== void 0 ? { description } : {},
+        ...defaultSubscription ? { default_subscription: defaultSubscription } : {},
+        ...visibility ? { visibility } : {}
+      },
+      options
+    );
+    return makeToolResult(`Tag ${result.id} updated.`, result);
+  }
+  if (toolName === "tag.delete") {
+    const publicationId = readRequiredString(args, "publicationId");
+    const tagId = readRequiredString(args, "tagId");
+    const result = await callRestApi(
+      "DELETE",
+      `/v1/tags/${encodeURIComponent(tagId)}?publication_id=${encodeURIComponent(publicationId)}`,
+      void 0,
+      options
+    );
+    return makeToolResult(`Tag ${result.id} deleted.`, result);
+  }
+  if (toolName === "api_key.create") {
+    const name = readRequiredString(args, "name");
+    const permission = asOptionalString(args.permission);
+    const domainId = asOptionalString(args.domain_id);
+    const result = await callRestApi(
+      "POST",
+      "/v1/api-keys",
+      {
+        name,
+        ...permission ? { permission } : {},
+        ...domainId ? { domain_id: domainId } : {}
+      },
+      options
+    );
+    return makeToolResult(
+      `API key ${result.id} created. Store this token now \u2014 it won't be shown again: ${result.token}`,
+      result
+    );
+  }
+  if (toolName === "api_key.list") {
+    const result = await callRestApi(
+      "GET",
+      "/v1/api-keys",
+      void 0,
+      options
+    );
+    return makeToolResult(`${result.data.length} API key(s).`, result);
+  }
+  if (toolName === "api_key.revoke") {
+    const keyId = readRequiredString(args, "keyId");
+    await callRestApi(
+      "DELETE",
+      `/v1/api-keys/${encodeURIComponent(keyId)}`,
+      void 0,
+      options
+    );
+    return makeToolResult(`API key ${keyId} revoked.`, { id: keyId, revoked: true });
+  }
+  throw new Error(`Unknown tool: ${toolName}`);
+}
+async function readResource(uri, options) {
+  if (uri === "publication://current/brand-guidelines") {
+    return {
+      contents: [
+        {
+          uri,
+          mimeType: "application/json",
+          text: JSON.stringify(
+            {
+              tone: ["clear", "friendly", "direct"],
+              style: "short paragraphs, concrete statements, one CTA",
+              banned: ["vague hype", "unverifiable claims"]
+            },
+            null,
+            2
+          )
+        }
+      ]
+    };
+  }
+  if (uri === "mailtea://capabilities") {
+    return {
+      contents: [
+        {
+          uri,
+          mimeType: "application/json",
+          text: JSON.stringify(
+            {
+              apiBaseUrl: resolveApiBaseUrl(options),
+              hasToken: Boolean(resolveToken(options)),
+              tools: MCP_TOOLS.map((tool) => tool.name),
+              notes: [
+                "All tools call Mailtea API endpoints.",
+                "Use a PAT or Better Auth session token in Authorization header."
+              ]
+            },
+            null,
+            2
+          )
+        }
+      ]
+    };
+  }
+  const analyticsUri = parseAnalyticsSummaryUri(uri);
+  if (analyticsUri) {
+    const summary = await loadLatestAnalyticsSummary(options, {
+      publicationId: analyticsUri.publicationId,
+      range: analyticsUri.range
+    });
+    return {
+      contents: [
+        {
+          uri,
+          mimeType: "application/json",
+          text: JSON.stringify(summary, null, 2)
+        }
+      ]
+    };
+  }
+  throw new Error(`Unknown resource: ${uri}`);
+}
+function readPrompt(name) {
+  if (name === "newsletter.draft_from_brief") {
+    return {
+      description: "Create a newsletter draft from a short brief",
+      messages: [
+        {
+          role: "user",
+          content: {
+            type: "text",
+            text: "Write a concise newsletter with clear sections and one CTA."
+          }
+        }
+      ]
+    };
+  }
+  if (name === "newsletter.subject_line_pack") {
+    return {
+      description: "Generate subject line variants",
+      messages: [
+        {
+          role: "user",
+          content: {
+            type: "text",
+            text: "Generate 10 subject lines with varied tone and urgency."
+          }
+        }
+      ]
+    };
+  }
+  throw new Error(`Unknown prompt: ${name}`);
+}
+async function handleMcpRequest(request, options = {}) {
+  const id = request.id ?? null;
+  try {
+    switch (request.method) {
+      case "initialize":
+        return response(id, {
+          protocolVersion: "2025-06-18",
+          serverInfo: {
+            name: "mailtea-mcp",
+            version: "0.2.0"
+          },
+          capabilities: {
+            tools: {},
+            resources: {},
+            prompts: {}
+          }
+        });
+      case "tools/list":
+        return response(id, { tools: MCP_TOOLS });
+      case "resources/list":
+        return response(id, { resources: MCP_RESOURCES });
+      case "resources/read": {
+        const uri = asOptionalString(request.params?.uri);
+        if (!uri) {
+          return error(id, -32602, "Missing required param: uri");
+        }
+        return response(id, await readResource(uri, options));
+      }
+      case "prompts/list":
+        return response(id, { prompts: MCP_PROMPTS });
+      case "prompts/get": {
+        const promptName = asOptionalString(request.params?.name);
+        if (!promptName) {
+          return error(id, -32602, "Missing required param: name");
+        }
+        return response(id, readPrompt(promptName));
+      }
+      case "tools/call": {
+        const params = asObject(request.params);
+        const toolName = asOptionalString(params.name);
+        if (!toolName) {
+          return error(id, -32602, "Missing required param: name");
+        }
+        const argumentsValue = params.arguments;
+        if (argumentsValue !== void 0 && (!argumentsValue || typeof argumentsValue !== "object" || Array.isArray(argumentsValue))) {
+          return error(id, -32602, "Param arguments must be an object");
+        }
+        const args = argumentsValue ?? {};
+        const result = await runTool(toolName, args, options);
+        return response(id, result);
+      }
+      case "notifications/initialized":
+        return response(id, {});
+      default:
+        return error(id, -32601, "Method not found", { method: request.method });
+    }
+  } catch (err) {
+    return error(id, -32e3, toErrorMessage(err));
+  }
+}
+
+export {
+  MCP_TOOLS,
+  MCP_RESOURCES,
+  MCP_PROMPTS,
+  handleMcpRequest
+};