mailtea-mcp 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,2313 @@
+type JsonRpcId = string | number | null;
+type JsonRpcRequest = {
+    jsonrpc: "2.0";
+    id?: JsonRpcId;
+    method: string;
+    params?: Record<string, unknown>;
+};
+type JsonRpcResponse = {
+    jsonrpc: "2.0";
+    id: JsonRpcId;
+    result?: unknown;
+    error?: {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
+};
+type McpRuntimeOptions = {
+    apiBaseUrl?: string;
+    token?: string | null;
+    publicationId?: string | null;
+    fetchImpl?: typeof fetch;
+};
+declare const MCP_TOOLS: readonly [{
+    readonly name: "auth.me";
+    readonly description: "Return auth identity for current token";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {};
+    };
+}, {
+    readonly name: "issue.create_draft";
+    readonly 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 — use template.list/template.get to find one — with {{variables}} substituted), contentHtml (raw HTML), or contentSpec (json-render spec). Spec is recommended for AI agents — use components: Html, Head, Body, Container, Section, Row, Column, Heading, Text, Link, Button, Image, Hr, Preview, Markdown, MailteaHeader, MailteaFooter, MailteaSpacer, MailteaContentBlock.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly publicationId: {
+                readonly type: "string";
+            };
+            readonly title: {
+                readonly type: "string";
+            };
+            readonly kind: {
+                readonly type: "string";
+                readonly enum: readonly ["newsletter", "broadcast"];
+                readonly description: "Email kind. 'newsletter' (default) can publish to the public site; 'broadcast' is one-time email-only.";
+            };
+            readonly templateId: {
+                readonly type: "string";
+                readonly description: "Seed the draft from a published server template (see template.list). Takes precedence over contentHtml/contentSpec.";
+            };
+            readonly variables: {
+                readonly type: "object";
+                readonly description: "Key/value map substituted into the template's {{variable}} placeholders when templateId is set.";
+            };
+            readonly contentHtml: {
+                readonly type: "string";
+                readonly description: "Raw HTML content (use this OR contentSpec OR templateId)";
+            };
+            readonly contentSpec: {
+                readonly type: "object";
+                readonly description: "json-render spec (flat element map). Use this OR contentHtml OR templateId. Properties: root (string, element key), elements (record of {type, props?, children?})";
+                readonly properties: {
+                    readonly root: {
+                        readonly type: "string";
+                    };
+                    readonly elements: {
+                        readonly type: "object";
+                    };
+                };
+                readonly required: readonly ["root", "elements"];
+            };
+        };
+        readonly required: readonly ["publicationId", "title"];
+    };
+}, {
+    readonly name: "issue.get_editor";
+    readonly description: "Load issue editor payload for a draft or scheduled issue";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly issueId: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["issueId"];
+    };
+}, {
+    readonly name: "issue.update_draft";
+    readonly description: "Update an existing draft issue. Provide contentHtml (raw HTML) or contentSpec (json-render spec).";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly issueId: {
+                readonly type: "string";
+            };
+            readonly title: {
+                readonly type: "string";
+            };
+            readonly contentHtml: {
+                readonly type: "string";
+                readonly description: "Raw HTML content (use this OR contentSpec)";
+            };
+            readonly contentSpec: {
+                readonly type: "object";
+                readonly description: "json-render spec (flat element map). Use this OR contentHtml.";
+                readonly properties: {
+                    readonly root: {
+                        readonly type: "string";
+                    };
+                    readonly elements: {
+                        readonly type: "object";
+                    };
+                };
+                readonly required: readonly ["root", "elements"];
+            };
+        };
+        readonly required: readonly ["issueId", "title"];
+    };
+}, {
+    readonly name: "issue.remove_draft";
+    readonly description: "Delete an existing draft issue";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly issueId: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["issueId"];
+    };
+}, {
+    readonly name: "issue.list_recent";
+    readonly description: "List recent issues for a publication";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly publicationId: {
+                readonly type: "string";
+            };
+            readonly limit: {
+                readonly type: "number";
+            };
+        };
+        readonly required: readonly ["publicationId"];
+    };
+}, {
+    readonly name: "publication.list";
+    readonly description: "List publication workspaces available to current user/token";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {};
+    };
+}, {
+    readonly name: "publication.create";
+    readonly description: "Create a publication workspace and attach owner membership";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly publicationId: {
+                readonly type: "string";
+            };
+            readonly name: {
+                readonly type: "string";
+            };
+            readonly timezone: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["name"];
+    };
+}, {
+    readonly name: "publication.domain_list";
+    readonly description: "List custom domains connected to a publication";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly publicationId: {
+                readonly type: "string";
+            };
+            readonly limit: {
+                readonly type: "number";
+            };
+        };
+        readonly required: readonly ["publicationId"];
+    };
+}, {
+    readonly name: "publication.domain_upsert";
+    readonly description: "Create or update a publication custom domain";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly publicationId: {
+                readonly type: "string";
+            };
+            readonly host: {
+                readonly type: "string";
+            };
+            readonly isPrimary: {
+                readonly type: "boolean";
+            };
+            readonly proxyTarget: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["publicationId", "host"];
+    };
+}, {
+    readonly name: "publication.domain_verify";
+    readonly description: "Mark a publication domain as verified";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly publicationId: {
+                readonly type: "string";
+            };
+            readonly domainId: {
+                readonly type: "string";
+            };
+            readonly verificationValue: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["publicationId", "domainId"];
+    };
+}, {
+    readonly name: "publication.domain_set_primary";
+    readonly description: "Set an existing publication domain as primary";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly publicationId: {
+                readonly type: "string";
+            };
+            readonly domainId: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["publicationId", "domainId"];
+    };
+}, {
+    readonly name: "publication.domain_remove";
+    readonly description: "Remove a publication custom domain";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly publicationId: {
+                readonly type: "string";
+            };
+            readonly domainId: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["publicationId", "domainId"];
+    };
+}, {
+    readonly name: "publication.domain_traefik_preview";
+    readonly description: "Generate Traefik dynamic-file preview for publication domains";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly publicationId: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["publicationId"];
+    };
+}, {
+    readonly name: "contact.list";
+    readonly description: "List contacts for a publication";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly publicationId: {
+                readonly type: "string";
+            };
+            readonly status: {
+                readonly type: "string";
+                readonly enum: readonly ["active", "unsubscribed", "suppressed"];
+            };
+            readonly query: {
+                readonly type: "string";
+            };
+            readonly limit: {
+                readonly type: "number";
+            };
+        };
+        readonly required: readonly ["publicationId"];
+    };
+}, {
+    readonly name: "contact.upsert";
+    readonly description: "Create or reactivate a contact by email";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly publicationId: {
+                readonly type: "string";
+            };
+            readonly email: {
+                readonly type: "string";
+            };
+            readonly referrerContactId: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["publicationId", "email"];
+    };
+}, {
+    readonly name: "contact.set_status";
+    readonly description: "Set contact status (active, unsubscribed, suppressed)";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly publicationId: {
+                readonly type: "string";
+            };
+            readonly contactId: {
+                readonly type: "string";
+            };
+            readonly status: {
+                readonly type: "string";
+                readonly enum: readonly ["active", "unsubscribed", "suppressed"];
+            };
+        };
+        readonly required: readonly ["publicationId", "contactId", "status"];
+    };
+}, {
+    readonly name: "contact.import_csv";
+    readonly description: "Import contacts from CSV text payload";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly publicationId: {
+                readonly type: "string";
+            };
+            readonly csvText: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["publicationId", "csvText"];
+    };
+}, {
+    readonly name: "contact.referral_summary";
+    readonly description: "Load referral conversion leaderboard for a publication";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly publicationId: {
+                readonly type: "string";
+            };
+            readonly limit: {
+                readonly type: "number";
+            };
+        };
+        readonly required: readonly ["publicationId"];
+    };
+}, {
+    readonly name: "contact.referral_milestones";
+    readonly description: "List referral milestone rules for a publication";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly publicationId: {
+                readonly type: "string";
+            };
+            readonly limit: {
+                readonly type: "number";
+            };
+        };
+        readonly required: readonly ["publicationId"];
+    };
+}, {
+    readonly name: "contact.referral_milestone_upsert";
+    readonly description: "Create or update a referral milestone rule";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly publicationId: {
+                readonly type: "string";
+            };
+            readonly milestoneId: {
+                readonly type: "string";
+            };
+            readonly title: {
+                readonly type: "string";
+            };
+            readonly description: {
+                readonly type: "string";
+            };
+            readonly referralCount: {
+                readonly type: "number";
+            };
+        };
+        readonly required: readonly ["publicationId", "title", "referralCount"];
+    };
+}, {
+    readonly name: "contact.referral_milestone_remove";
+    readonly description: "Delete a referral milestone rule";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly publicationId: {
+                readonly type: "string";
+            };
+            readonly milestoneId: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["publicationId", "milestoneId"];
+    };
+}, {
+    readonly name: "contact.referral_rewards";
+    readonly description: "List awarded referral rewards for a publication";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly publicationId: {
+                readonly type: "string";
+            };
+            readonly contactId: {
+                readonly type: "string";
+            };
+            readonly limit: {
+                readonly type: "number";
+            };
+        };
+        readonly required: readonly ["publicationId"];
+    };
+}, {
+    readonly name: "monetize.offer_list";
+    readonly description: "List sponsor offers for a publication";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly publicationId: {
+                readonly type: "string";
+            };
+            readonly status: {
+                readonly type: "string";
+                readonly enum: readonly ["draft", "active", "paused", "archived"];
+            };
+            readonly limit: {
+                readonly type: "number";
+            };
+        };
+        readonly required: readonly ["publicationId"];
+    };
+}, {
+    readonly name: "monetize.offer_upsert";
+    readonly description: "Create or update a sponsor offer";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly publicationId: {
+                readonly type: "string";
+            };
+            readonly offerId: {
+                readonly type: "string";
+            };
+            readonly title: {
+                readonly type: "string";
+            };
+            readonly sponsorName: {
+                readonly type: "string";
+            };
+            readonly description: {
+                readonly type: "string";
+            };
+            readonly pricingModel: {
+                readonly type: "string";
+                readonly enum: readonly ["flat", "cpm"];
+            };
+            readonly rateCents: {
+                readonly type: "number";
+            };
+            readonly estimatedPlacements: {
+                readonly type: "number";
+            };
+            readonly status: {
+                readonly type: "string";
+                readonly enum: readonly ["draft", "active", "paused", "archived"];
+            };
+            readonly startsAt: {
+                readonly type: "string";
+                readonly description: "Optional ISO start timestamp.";
+            };
+            readonly endsAt: {
+                readonly type: "string";
+                readonly description: "Optional ISO end timestamp.";
+            };
+        };
+        readonly required: readonly ["publicationId", "title", "sponsorName", "pricingModel", "rateCents"];
+    };
+}, {
+    readonly name: "monetize.offer_remove";
+    readonly description: "Delete a sponsor offer";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly publicationId: {
+                readonly type: "string";
+            };
+            readonly offerId: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["publicationId", "offerId"];
+    };
+}, {
+    readonly name: "section.list";
+    readonly description: "List reusable editor sections for a publication";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly publicationId: {
+                readonly type: "string";
+            };
+            readonly limit: {
+                readonly type: "number";
+            };
+        };
+        readonly required: readonly ["publicationId"];
+    };
+}, {
+    readonly name: "section.catalog";
+    readonly description: "List shared marketplace section packs";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly publicationId: {
+                readonly type: "string";
+                readonly description: "Optional publication id to include custom packs";
+            };
+        };
+    };
+}, {
+    readonly name: "section.pack_create";
+    readonly description: "Create a custom marketplace pack for a publication";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly publicationId: {
+                readonly type: "string";
+            };
+            readonly title: {
+                readonly type: "string";
+            };
+            readonly description: {
+                readonly type: "string";
+            };
+            readonly styleProfile: {
+                readonly type: "object";
+                readonly description: "Optional React Email style profile for this template pack.";
+            };
+            readonly sections: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly name: {
+                            readonly type: "string";
+                        };
+                        readonly contentJson: {
+                            readonly type: "array";
+                            readonly items: {
+                                readonly type: "object";
+                            };
+                            readonly minItems: 1;
+                        };
+                    };
+                    readonly required: readonly ["name", "contentJson"];
+                };
+                readonly minItems: 1;
+            };
+        };
+        readonly required: readonly ["publicationId", "title", "sections"];
+    };
+}, {
+    readonly name: "section.pack_update";
+    readonly description: "Update a custom marketplace pack";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly publicationId: {
+                readonly type: "string";
+            };
+            readonly packId: {
+                readonly type: "string";
+            };
+            readonly title: {
+                readonly type: "string";
+            };
+            readonly description: {
+                readonly type: "string";
+            };
+            readonly styleProfile: {
+                readonly type: "object";
+                readonly description: "Optional React Email style profile for this template pack.";
+            };
+            readonly sections: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly name: {
+                            readonly type: "string";
+                        };
+                        readonly contentJson: {
+                            readonly type: "array";
+                            readonly items: {
+                                readonly type: "object";
+                            };
+                            readonly minItems: 1;
+                        };
+                    };
+                    readonly required: readonly ["name", "contentJson"];
+                };
+                readonly minItems: 1;
+            };
+        };
+        readonly required: readonly ["publicationId", "packId", "title", "sections"];
+    };
+}, {
+    readonly name: "section.pack_remove";
+    readonly description: "Delete a custom marketplace pack";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly publicationId: {
+                readonly type: "string";
+            };
+            readonly packId: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["publicationId", "packId"];
+    };
+}, {
+    readonly name: "section.pack_revisions";
+    readonly description: "List version history for a custom marketplace pack";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly publicationId: {
+                readonly type: "string";
+            };
+            readonly packId: {
+                readonly type: "string";
+            };
+            readonly limit: {
+                readonly type: "number";
+            };
+        };
+        readonly required: readonly ["publicationId", "packId"];
+    };
+}, {
+    readonly name: "section.pack_restore_revision";
+    readonly description: "Restore a custom marketplace pack to a specific revision";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly publicationId: {
+                readonly type: "string";
+            };
+            readonly packId: {
+                readonly type: "string";
+            };
+            readonly revisionId: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["publicationId", "packId", "revisionId"];
+    };
+}, {
+    readonly name: "section.import_pack";
+    readonly description: "Import a marketplace pack into reusable sections";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly publicationId: {
+                readonly type: "string";
+            };
+            readonly presetId: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["publicationId", "presetId"];
+    };
+}, {
+    readonly name: "section.create";
+    readonly description: "Create a reusable section snippet";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly publicationId: {
+                readonly type: "string";
+            };
+            readonly name: {
+                readonly type: "string";
+            };
+            readonly contentJson: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "object";
+                };
+                readonly minItems: 1;
+            };
+        };
+        readonly required: readonly ["publicationId", "name", "contentJson"];
+    };
+}, {
+    readonly name: "section.update";
+    readonly description: "Update a reusable section snippet";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly sectionId: {
+                readonly type: "string";
+            };
+            readonly name: {
+                readonly type: "string";
+            };
+            readonly contentJson: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "object";
+                };
+                readonly minItems: 1;
+            };
+        };
+        readonly required: readonly ["sectionId", "name", "contentJson"];
+    };
+}, {
+    readonly name: "section.remove";
+    readonly description: "Delete a reusable section snippet";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly sectionId: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["sectionId"];
+    };
+}, {
+    readonly name: "issue.preview";
+    readonly description: "Preview newsletter HTML for an issue";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly issueId: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["issueId"];
+    };
+}, {
+    readonly name: "issue.preview_draft";
+    readonly description: "Preview newsletter HTML/text for unsaved draft content";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly publicationId: {
+                readonly type: "string";
+            };
+            readonly title: {
+                readonly type: "string";
+            };
+            readonly html: {
+                readonly type: "string";
+            };
+            readonly plainText: {
+                readonly type: "string";
+            };
+            readonly styleProfile: {
+                readonly type: "object";
+                readonly description: "Optional React Email style profile overrides.";
+            };
+        };
+        readonly required: readonly ["publicationId", "title", "html"];
+    };
+}, {
+    readonly name: "issue.delivery_progress";
+    readonly description: "Fetch send progress snapshot for an issue";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly publicationId: {
+                readonly type: "string";
+            };
+            readonly issueId: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["publicationId", "issueId"];
+    };
+}, {
+    readonly name: "issue.wait_delivery";
+    readonly description: "Poll issue send progress until sent/failed or timeout";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly publicationId: {
+                readonly type: "string";
+            };
+            readonly issueId: {
+                readonly type: "string";
+            };
+            readonly timeoutMs: {
+                readonly type: "number";
+                readonly description: "Optional timeout in milliseconds. Defaults to 60000.";
+            };
+            readonly pollIntervalMs: {
+                readonly type: "number";
+                readonly description: "Optional polling interval in milliseconds. Defaults to 2000.";
+            };
+        };
+        readonly required: readonly ["publicationId", "issueId"];
+    };
+}, {
+    readonly name: "analytics.poll_results";
+    readonly description: "Fetch poll vote totals for a specific issue";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly publicationId: {
+                readonly type: "string";
+            };
+            readonly issueId: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["publicationId", "issueId"];
+    };
+}, {
+    readonly name: "analytics.issue_performance";
+    readonly description: "Fetch open/click delivery analytics for an issue";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly publicationId: {
+                readonly type: "string";
+            };
+            readonly issueId: {
+                readonly type: "string";
+            };
+            readonly range: {
+                readonly type: "string";
+                readonly enum: readonly ["24h", "7d", "30d", "all"];
+                readonly description: "Analytics window. Defaults to all.";
+            };
+        };
+        readonly required: readonly ["publicationId", "issueId"];
+    };
+}, {
+    readonly name: "analytics.issue_trend";
+    readonly description: "Fetch daily open/click trend buckets for an issue";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly publicationId: {
+                readonly type: "string";
+            };
+            readonly issueId: {
+                readonly type: "string";
+            };
+            readonly range: {
+                readonly type: "string";
+                readonly enum: readonly ["24h", "7d", "30d", "all"];
+                readonly description: "Analytics window. Defaults to all.";
+            };
+        };
+        readonly required: readonly ["publicationId", "issueId"];
+    };
+}, {
+    readonly name: "analytics.latest_summary";
+    readonly description: "Fetch latest issue analytics snapshot for a publication";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly publicationId: {
+                readonly type: "string";
+                readonly description: "Optional publication id. Falls back to MAILTEA_PUBLICATION_ID.";
+            };
+            readonly range: {
+                readonly type: "string";
+                readonly enum: readonly ["24h", "7d", "30d", "all"];
+                readonly description: "Analytics window. Defaults to 7d.";
+            };
+        };
+    };
+}, {
+    readonly name: "analytics.issue_export_csv";
+    readonly description: "Export issue performance and poll analytics as CSV";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly publicationId: {
+                readonly type: "string";
+            };
+            readonly issueId: {
+                readonly type: "string";
+            };
+            readonly range: {
+                readonly type: "string";
+                readonly enum: readonly ["24h", "7d", "30d", "all"];
+                readonly description: "Analytics window. Defaults to all.";
+            };
+            readonly exportType: {
+                readonly type: "string";
+                readonly enum: readonly ["combined", "performance", "polls"];
+                readonly description: "CSV type. Defaults to combined.";
+            };
+        };
+        readonly required: readonly ["publicationId", "issueId"];
+    };
+}, {
+    readonly name: "analytics.issue_export_performance_csv";
+    readonly description: "Export issue performance-only analytics as CSV";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly publicationId: {
+                readonly type: "string";
+            };
+            readonly issueId: {
+                readonly type: "string";
+            };
+            readonly range: {
+                readonly type: "string";
+                readonly enum: readonly ["24h", "7d", "30d", "all"];
+                readonly description: "Analytics window. Defaults to all.";
+            };
+        };
+        readonly required: readonly ["publicationId", "issueId"];
+    };
+}, {
+    readonly name: "analytics.issue_export_polls_csv";
+    readonly description: "Export issue poll-only analytics as CSV";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly publicationId: {
+                readonly type: "string";
+            };
+            readonly issueId: {
+                readonly type: "string";
+            };
+            readonly range: {
+                readonly type: "string";
+                readonly enum: readonly ["24h", "7d", "30d", "all"];
+                readonly description: "Analytics window. Defaults to all.";
+            };
+        };
+        readonly required: readonly ["publicationId", "issueId"];
+    };
+}, {
+    readonly name: "issue.schedule";
+    readonly description: "Schedule an issue for delivery";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly issueId: {
+                readonly type: "string";
+            };
+            readonly scheduledFor: {
+                readonly type: "string";
+                readonly description: "ISO timestamp (optional). Defaults to now.";
+            };
+        };
+        readonly required: readonly ["issueId"];
+    };
+}, {
+    readonly name: "issue.unschedule";
+    readonly description: "Cancel an issue schedule and move it back to draft";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly issueId: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["issueId"];
+    };
+}, {
+    readonly name: "issue.publish_to_web";
+    readonly description: "Publish an issue to the publication's public website, making it readable on the web (typically a sent issue).";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly issueId: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["issueId"];
+    };
+}, {
+    readonly name: "issue.unpublish_from_web";
+    readonly description: "Remove an issue from the publication's public website.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly issueId: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["issueId"];
+    };
+}, {
+    readonly name: "issue.send_now";
+    readonly description: "Send an issue immediately";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly issueId: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["issueId"];
+    };
+}, {
+    readonly name: "issue.send_and_wait";
+    readonly description: "Send an issue now and poll until sent/failed or timeout";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly issueId: {
+                readonly type: "string";
+            };
+            readonly timeoutMs: {
+                readonly type: "number";
+                readonly description: "Optional timeout in milliseconds. Defaults to 60000.";
+            };
+            readonly pollIntervalMs: {
+                readonly type: "number";
+                readonly description: "Optional polling interval in milliseconds. Defaults to 2000.";
+            };
+        };
+        readonly required: readonly ["issueId"];
+    };
+}, {
+    readonly name: "ai.generate_draft";
+    readonly description: "Generate a draft from a prompt";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly publicationId: {
+                readonly type: "string";
+            };
+            readonly prompt: {
+                readonly type: "string";
+            };
+            readonly tone: {
+                readonly type: "string";
+                readonly enum: readonly ["neutral", "friendly", "formal"];
+            };
+        };
+        readonly required: readonly ["publicationId", "prompt"];
+    };
+}, {
+    readonly name: "template.create";
+    readonly description: "Create an email template. Provide html (raw HTML) or spec (json-render spec). Spec is recommended — 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.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly publicationId: {
+                readonly type: "string";
+                readonly description: "Publication to create template in";
+            };
+            readonly name: {
+                readonly type: "string";
+                readonly description: "Template name (max 120 chars)";
+            };
+            readonly html: {
+                readonly type: "string";
+                readonly description: "Raw HTML content (use this OR spec)";
+            };
+            readonly spec: {
+                readonly type: "object";
+                readonly description: "json-render spec (flat element map). Use this OR html.";
+                readonly properties: {
+                    readonly root: {
+                        readonly type: "string";
+                    };
+                    readonly elements: {
+                        readonly type: "object";
+                    };
+                };
+                readonly required: readonly ["root", "elements"];
+            };
+            readonly description: {
+                readonly type: "string";
+                readonly description: "Template description (max 500 chars)";
+            };
+            readonly subject: {
+                readonly type: "string";
+                readonly description: "Default email subject line";
+            };
+            readonly variables: {
+                readonly type: "array";
+                readonly description: "Template variables with fallback values";
+                readonly items: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly key: {
+                            readonly type: "string";
+                        };
+                        readonly type: {
+                            readonly type: "string";
+                            readonly enum: readonly ["string", "number"];
+                        };
+                        readonly fallback_value: {};
+                    };
+                    readonly required: readonly ["key", "type"];
+                };
+            };
+        };
+        readonly required: readonly ["publicationId", "name"];
+    };
+}, {
+    readonly name: "template.list";
+    readonly description: "List email templates for a publication";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly publicationId: {
+                readonly type: "string";
+            };
+            readonly limit: {
+                readonly type: "number";
+                readonly description: "Max results (1-100, default 20)";
+            };
+        };
+        readonly required: readonly ["publicationId"];
+    };
+}, {
+    readonly name: "template.get";
+    readonly description: "Get a single email template by ID, including its spec and rendered HTML";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly publicationId: {
+                readonly type: "string";
+            };
+            readonly templateId: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["publicationId", "templateId"];
+    };
+}, {
+    readonly name: "template.update";
+    readonly 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.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly publicationId: {
+                readonly type: "string";
+            };
+            readonly templateId: {
+                readonly type: "string";
+            };
+            readonly name: {
+                readonly type: "string";
+            };
+            readonly html: {
+                readonly type: "string";
+                readonly description: "Raw HTML content (switches the template to raw HTML).";
+            };
+            readonly spec: {
+                readonly type: "object";
+                readonly description: "json-render spec (flat element map). Re-renders email-safe HTML server-side.";
+                readonly properties: {
+                    readonly root: {
+                        readonly type: "string";
+                    };
+                    readonly elements: {
+                        readonly type: "object";
+                    };
+                };
+                readonly required: readonly ["root", "elements"];
+            };
+            readonly description: {
+                readonly type: "string";
+            };
+            readonly text: {
+                readonly type: "string";
+                readonly description: "Plain-text body.";
+            };
+            readonly subject: {
+                readonly type: "string";
+            };
+            readonly from: {
+                readonly type: "string";
+                readonly description: "Default sender address.";
+            };
+            readonly reply_to: {
+                readonly type: "string";
+            };
+            readonly variables: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly key: {
+                            readonly type: "string";
+                        };
+                        readonly type: {
+                            readonly type: "string";
+                            readonly enum: readonly ["string", "number"];
+                        };
+                        readonly fallback_value: {};
+                    };
+                    readonly required: readonly ["key", "type"];
+                };
+            };
+        };
+        readonly required: readonly ["publicationId", "templateId"];
+    };
+}, {
+    readonly name: "template.publish";
+    readonly description: "Publish a draft email template, making it the active version for sends.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly publicationId: {
+                readonly type: "string";
+            };
+            readonly templateId: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["publicationId", "templateId"];
+    };
+}, {
+    readonly name: "template.duplicate";
+    readonly description: "Duplicate an email template into a new draft copy.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly publicationId: {
+                readonly type: "string";
+            };
+            readonly templateId: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["publicationId", "templateId"];
+    };
+}, {
+    readonly name: "template.delete";
+    readonly description: "Delete an email template.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly publicationId: {
+                readonly type: "string";
+            };
+            readonly templateId: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["publicationId", "templateId"];
+    };
+}, {
+    readonly name: "email.send";
+    readonly description: "Send a transactional email to one or more specific recipients. Provide inline content (html and/or text) OR a template reference — 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.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly from: {
+                readonly type: "string";
+                readonly description: "Sender, e.g. 'Acme <hello@acme.com>'. Must use a verified domain.";
+            };
+            readonly to: {
+                readonly type: readonly ["string", "array"];
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly description: "Recipient address, or array of up to 50 addresses.";
+            };
+            readonly subject: {
+                readonly type: "string";
+                readonly description: "Subject line (max 998 chars).";
+            };
+            readonly html: {
+                readonly type: "string";
+                readonly description: "HTML body. Use this OR template, not both.";
+            };
+            readonly text: {
+                readonly type: "string";
+                readonly description: "Plain-text body.";
+            };
+            readonly template: {
+                readonly type: "object";
+                readonly description: "Stored template reference to render instead of inline html.";
+                readonly properties: {
+                    readonly id: {
+                        readonly type: "string";
+                    };
+                    readonly variables: {
+                        readonly type: "object";
+                        readonly description: "Template variable values.";
+                    };
+                };
+                readonly required: readonly ["id"];
+            };
+            readonly cc: {
+                readonly type: readonly ["string", "array"];
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly description: "CC address(es).";
+            };
+            readonly bcc: {
+                readonly type: readonly ["string", "array"];
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly description: "BCC address(es).";
+            };
+            readonly reply_to: {
+                readonly type: readonly ["string", "array"];
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly description: "Reply-To address(es).";
+            };
+            readonly scheduled_at: {
+                readonly type: "string";
+                readonly description: "ISO 8601 datetime to schedule the send. Omit to send immediately.";
+            };
+            readonly tags: {
+                readonly type: "array";
+                readonly description: "Custom tags for filtering/analytics.";
+                readonly items: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly name: {
+                            readonly type: "string";
+                        };
+                        readonly value: {
+                            readonly type: "string";
+                        };
+                    };
+                    readonly required: readonly ["name", "value"];
+                };
+            };
+            readonly headers: {
+                readonly type: "object";
+                readonly description: "Custom email headers (string values).";
+            };
+            readonly attachments: {
+                readonly type: "array";
+                readonly description: "File attachments.";
+                readonly items: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly filename: {
+                            readonly type: "string";
+                        };
+                        readonly content: {
+                            readonly type: "string";
+                            readonly description: "Base64-encoded file content.";
+                        };
+                        readonly content_type: {
+                            readonly type: "string";
+                        };
+                        readonly content_id: {
+                            readonly type: "string";
+                            readonly description: "For inline images (cid:).";
+                        };
+                    };
+                    readonly required: readonly ["filename", "content"];
+                };
+            };
+        };
+        readonly required: readonly ["from", "to", "subject"];
+    };
+}, {
+    readonly name: "email.batch";
+    readonly 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.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly emails: {
+                readonly type: "array";
+                readonly description: "1-100 email objects: { from, to, subject, html?|text?|template?, cc?, bcc?, reply_to?, tags?, headers? }.";
+                readonly items: {
+                    readonly type: "object";
+                };
+            };
+        };
+        readonly required: readonly ["emails"];
+    };
+}, {
+    readonly name: "email.get";
+    readonly description: "Retrieve a transactional email by id with its delivery status (last_event) and tracking counters (open_count, click_count).";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["id"];
+    };
+}, {
+    readonly name: "email.reschedule";
+    readonly description: "Reschedule a still-scheduled transactional email to a new time.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly id: {
+                readonly type: "string";
+            };
+            readonly scheduled_at: {
+                readonly type: "string";
+                readonly description: "New ISO 8601 datetime.";
+            };
+        };
+        readonly required: readonly ["id", "scheduled_at"];
+    };
+}, {
+    readonly name: "email.cancel";
+    readonly description: "Cancel a scheduled transactional email before it sends.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["id"];
+    };
+}, {
+    readonly name: "email.resend";
+    readonly description: "Resend a failed or bounced transactional email — creates a fresh copy with the same content. Only emails whose status is 'failed' or 'bounced' can be resent; others return an error.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["id"];
+    };
+}, {
+    readonly name: "email.list";
+    readonly description: "List transactional emails (most recent first). Filter by status and tags; paginate with limit/offset. Returns id, status, subject, recipient per email.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly status: {
+                readonly type: "string";
+                readonly enum: readonly ["queued", "sent", "delivered", "bounced", "complained", "failed", "scheduled", "canceled"];
+                readonly description: "Filter by delivery status.";
+            };
+            readonly limit: {
+                readonly type: "number";
+                readonly description: "Max results 1-100 (default 50).";
+            };
+            readonly offset: {
+                readonly type: "number";
+                readonly description: "Pagination offset (default 0).";
+            };
+            readonly tag_name: {
+                readonly type: "string";
+                readonly description: "Filter by a custom tag name.";
+            };
+            readonly tag_value: {
+                readonly type: "string";
+                readonly description: "Filter by a custom tag value (use with tag_name).";
+            };
+            readonly from_date: {
+                readonly type: "string";
+                readonly description: "ISO 8601 lower bound on created_at.";
+            };
+            readonly to_date: {
+                readonly type: "string";
+                readonly description: "ISO 8601 upper bound on created_at.";
+            };
+        };
+    };
+}, {
+    readonly name: "email.analytics";
+    readonly 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.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly from_date: {
+                readonly type: "string";
+                readonly description: "ISO 8601 lower bound on created_at.";
+            };
+            readonly to_date: {
+                readonly type: "string";
+                readonly description: "ISO 8601 upper bound on created_at.";
+            };
+        };
+    };
+}, {
+    readonly name: "email.inbound_list";
+    readonly description: "List inbound (received) emails for a publication, most recent first; paginate with limit/cursor. Only this inbound tool needs publicationId — email.inbound_get/list_attachments/get_attachment/reply resolve tenancy from the email id.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly publicationId: {
+                readonly type: "string";
+            };
+            readonly limit: {
+                readonly type: "number";
+                readonly description: "Max results (1-100, default 20).";
+            };
+            readonly cursor: {
+                readonly type: "string";
+                readonly description: "Opaque pagination cursor from a prior response's next_cursor.";
+            };
+        };
+        readonly required: readonly ["publicationId"];
+    };
+}, {
+    readonly name: "email.inbound_get";
+    readonly description: "Retrieve a single inbound email by id (rxemail_) — 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.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly id: {
+                readonly type: "string";
+                readonly description: "Inbound email id (rxemail_).";
+            };
+        };
+        readonly required: readonly ["id"];
+    };
+}, {
+    readonly name: "email.inbound_list_attachments";
+    readonly 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.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly id: {
+                readonly type: "string";
+                readonly description: "Inbound email id (rxemail_).";
+            };
+        };
+        readonly required: readonly ["id"];
+    };
+}, {
+    readonly name: "email.inbound_get_attachment";
+    readonly 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.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly id: {
+                readonly type: "string";
+                readonly description: "Inbound email id (rxemail_).";
+            };
+            readonly attachmentId: {
+                readonly type: "string";
+                readonly description: "Attachment id (rxatt_).";
+            };
+        };
+        readonly required: readonly ["id", "attachmentId"];
+    };
+}, {
+    readonly name: "email.inbound_reply";
+    readonly description: "Reply to an inbound email. The reply threads automatically — 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.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly id: {
+                readonly type: "string";
+                readonly description: "Inbound email id (rxemail_) to reply to.";
+            };
+            readonly from: {
+                readonly type: "object";
+                readonly description: "Sender override. Omit to send from the verified domain the original was delivered to.";
+                readonly properties: {
+                    readonly email: {
+                        readonly type: "string";
+                    };
+                    readonly name: {
+                        readonly type: "string";
+                    };
+                };
+                readonly required: readonly ["email"];
+            };
+            readonly subject: {
+                readonly type: "string";
+                readonly description: "Defaults to the original subject with a single 'Re: ' prefix.";
+            };
+            readonly html: {
+                readonly type: "string";
+                readonly description: "HTML body (provide html and/or text).";
+            };
+            readonly text: {
+                readonly type: "string";
+                readonly description: "Plain-text body (provide html and/or text).";
+            };
+            readonly cc: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly description: "CC addresses.";
+            };
+            readonly bcc: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly description: "BCC addresses.";
+            };
+            readonly idempotency_key: {
+                readonly type: "string";
+                readonly description: "Optional key to make the reply idempotent (the Idempotency-Key header wins when both are set).";
+            };
+        };
+        readonly required: readonly ["id"];
+    };
+}, {
+    readonly name: "issue.send_test";
+    readonly 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 — use issue.send_now for the real send.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly issueId: {
+                readonly type: "string";
+            };
+            readonly recipients: {
+                readonly type: readonly ["string", "array"];
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly description: "Test recipient address, or array of addresses.";
+            };
+            readonly from: {
+                readonly type: "string";
+                readonly description: "Sender, e.g. 'Acme <hello@acme.com>'. Must use a verified domain.";
+            };
+        };
+        readonly required: readonly ["issueId", "recipients", "from"];
+    };
+}, {
+    readonly name: "domain.create";
+    readonly 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.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly publicationId: {
+                readonly type: "string";
+            };
+            readonly name: {
+                readonly type: "string";
+                readonly description: "Domain host, e.g. 'mail.acme.com'.";
+            };
+            readonly purpose: {
+                readonly type: "string";
+                readonly enum: readonly ["email", "site", "both"];
+                readonly description: "Use 'email' or 'both' for a sending domain. Defaults to 'site'.";
+            };
+            readonly is_primary: {
+                readonly type: "boolean";
+            };
+        };
+        readonly required: readonly ["publicationId", "name"];
+    };
+}, {
+    readonly name: "domain.list";
+    readonly description: "List email/site domains for a publication.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly publicationId: {
+                readonly type: "string";
+            };
+            readonly limit: {
+                readonly type: "number";
+                readonly description: "Max results (1-100, default 20).";
+            };
+        };
+        readonly required: readonly ["publicationId"];
+    };
+}, {
+    readonly name: "domain.get";
+    readonly description: "Get a single domain including the DNS 'records' to add for verification.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly publicationId: {
+                readonly type: "string";
+            };
+            readonly domainId: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["publicationId", "domainId"];
+    };
+}, {
+    readonly name: "domain.verify";
+    readonly 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.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly publicationId: {
+                readonly type: "string";
+            };
+            readonly domainId: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["publicationId", "domainId"];
+    };
+}, {
+    readonly name: "domain.update";
+    readonly description: "Update a domain's purpose (email/site/both) or primary flag.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly publicationId: {
+                readonly type: "string";
+            };
+            readonly domainId: {
+                readonly type: "string";
+            };
+            readonly purpose: {
+                readonly type: "string";
+                readonly enum: readonly ["email", "site", "both"];
+            };
+            readonly is_primary: {
+                readonly type: "boolean";
+            };
+        };
+        readonly required: readonly ["publicationId", "domainId"];
+    };
+}, {
+    readonly name: "domain.delete";
+    readonly description: "Remove a domain from a publication.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly publicationId: {
+                readonly type: "string";
+            };
+            readonly domainId: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["publicationId", "domainId"];
+    };
+}, {
+    readonly name: "domain.tracking_create";
+    readonly description: "Add a tracking sub-domain (CNAME) under a domain — used to serve open-pixel/click-tracking links from your own domain. Returns the CNAME record to add, then call domain.tracking_verify.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly publicationId: {
+                readonly type: "string";
+            };
+            readonly domainId: {
+                readonly type: "string";
+                readonly description: "Parent domain ID.";
+            };
+            readonly subdomain: {
+                readonly type: "string";
+                readonly description: "Sub-domain label (lowercase alphanumeric and hyphens), e.g. 'links'.";
+            };
+        };
+        readonly required: readonly ["publicationId", "domainId", "subdomain"];
+    };
+}, {
+    readonly name: "domain.tracking_list";
+    readonly description: "List tracking sub-domains for a domain.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly publicationId: {
+                readonly type: "string";
+            };
+            readonly domainId: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["publicationId", "domainId"];
+    };
+}, {
+    readonly name: "domain.tracking_verify";
+    readonly description: "Verify a tracking sub-domain by checking its CNAME record; status becomes 'verified'.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly publicationId: {
+                readonly type: "string";
+            };
+            readonly domainId: {
+                readonly type: "string";
+            };
+            readonly trackingDomainId: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["publicationId", "domainId", "trackingDomainId"];
+    };
+}, {
+    readonly name: "domain.tracking_delete";
+    readonly description: "Remove a tracking sub-domain.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly publicationId: {
+                readonly type: "string";
+            };
+            readonly domainId: {
+                readonly type: "string";
+            };
+            readonly trackingDomainId: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["publicationId", "domainId", "trackingDomainId"];
+    };
+}, {
+    readonly name: "webhook.create";
+    readonly description: "Register an outbound webhook endpoint that receives delivery/engagement events. Returns a signing_secret (shown only once) used to verify payloads.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly publicationId: {
+                readonly type: "string";
+            };
+            readonly endpoint: {
+                readonly type: "string";
+                readonly description: "HTTPS URL to deliver events to.";
+            };
+            readonly events: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly description: "Event types, e.g. email.received, email.sent, email.delivered, email.bounced, email.opened, email.clicked, contact.created, contact.unsubscribed.";
+            };
+        };
+        readonly required: readonly ["publicationId", "endpoint", "events"];
+    };
+}, {
+    readonly name: "webhook.list";
+    readonly description: "List outbound webhooks for a publication (signing secrets omitted).";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly publicationId: {
+                readonly type: "string";
+            };
+            readonly limit: {
+                readonly type: "number";
+                readonly description: "Max results (1-100, default 20).";
+            };
+        };
+        readonly required: readonly ["publicationId"];
+    };
+}, {
+    readonly name: "webhook.get";
+    readonly description: "Get a single outbound webhook by ID.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly publicationId: {
+                readonly type: "string";
+            };
+            readonly webhookId: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["publicationId", "webhookId"];
+    };
+}, {
+    readonly name: "webhook.update";
+    readonly description: "Update a webhook's endpoint, subscribed events, or enabled/disabled status.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly publicationId: {
+                readonly type: "string";
+            };
+            readonly webhookId: {
+                readonly type: "string";
+            };
+            readonly endpoint: {
+                readonly type: "string";
+            };
+            readonly events: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+            };
+            readonly status: {
+                readonly type: "string";
+                readonly enum: readonly ["enabled", "disabled"];
+            };
+        };
+        readonly required: readonly ["publicationId", "webhookId"];
+    };
+}, {
+    readonly name: "webhook.delete";
+    readonly description: "Delete an outbound webhook.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly publicationId: {
+                readonly type: "string";
+            };
+            readonly webhookId: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["publicationId", "webhookId"];
+    };
+}, {
+    readonly name: "segment.create";
+    readonly description: "Create a saved audience segment defined by a status filter and/or a query filter (filter-based, not manual membership).";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly publicationId: {
+                readonly type: "string";
+            };
+            readonly name: {
+                readonly type: "string";
+            };
+            readonly description: {
+                readonly type: "string";
+            };
+            readonly status_filter: {
+                readonly type: "string";
+                readonly enum: readonly ["active", "unsubscribed", "suppressed"];
+            };
+            readonly query_filter: {
+                readonly type: "string";
+                readonly description: "Search/filter expression over contacts.";
+            };
+        };
+        readonly required: readonly ["publicationId", "name"];
+    };
+}, {
+    readonly name: "segment.list";
+    readonly description: "List saved audience segments for a publication.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly publicationId: {
+                readonly type: "string";
+            };
+            readonly limit: {
+                readonly type: "number";
+                readonly description: "Max results (1-100, default 20).";
+            };
+        };
+        readonly required: readonly ["publicationId"];
+    };
+}, {
+    readonly name: "segment.get";
+    readonly description: "Get a single audience segment by ID.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly publicationId: {
+                readonly type: "string";
+            };
+            readonly segmentId: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["publicationId", "segmentId"];
+    };
+}, {
+    readonly name: "segment.update";
+    readonly description: "Update an audience segment's name, description, or filters.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly publicationId: {
+                readonly type: "string";
+            };
+            readonly segmentId: {
+                readonly type: "string";
+            };
+            readonly name: {
+                readonly type: "string";
+            };
+            readonly description: {
+                readonly type: "string";
+            };
+            readonly status_filter: {
+                readonly type: readonly ["string", "null"];
+                readonly enum: readonly ["active", "unsubscribed", "suppressed", null];
+                readonly description: "Filter by contact status, or null to clear it.";
+            };
+            readonly query_filter: {
+                readonly type: readonly ["string", "null"];
+                readonly description: "Search/filter expression, or null to clear it.";
+            };
+        };
+        readonly required: readonly ["publicationId", "segmentId"];
+    };
+}, {
+    readonly name: "segment.delete";
+    readonly description: "Delete an audience segment.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly publicationId: {
+                readonly type: "string";
+            };
+            readonly segmentId: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["publicationId", "segmentId"];
+    };
+}, {
+    readonly name: "contact_property.create";
+    readonly description: "Define a custom contact property (custom field) for the team. Property values are set per-contact via contact.set_properties.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly key: {
+                readonly type: "string";
+                readonly description: "Property key (starts with a letter; letters, numbers, underscores).";
+            };
+            readonly type: {
+                readonly type: "string";
+                readonly enum: readonly ["string", "number"];
+            };
+            readonly fallback_value: {
+                readonly description: "Default value when a contact has none (matches type).";
+            };
+            readonly description: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["key", "type"];
+    };
+}, {
+    readonly name: "contact_property.list";
+    readonly description: "List the team's custom contact property definitions.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly limit: {
+                readonly type: "number";
+                readonly description: "Max results (1-100, default 20).";
+            };
+        };
+    };
+}, {
+    readonly name: "contact_property.update";
+    readonly description: "Update a custom contact property's fallback value or description.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly propertyId: {
+                readonly type: "string";
+            };
+            readonly fallback_value: {};
+            readonly description: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["propertyId"];
+    };
+}, {
+    readonly name: "contact_property.delete";
+    readonly description: "Delete a custom contact property definition.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly propertyId: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["propertyId"];
+    };
+}, {
+    readonly name: "contact.get";
+    readonly description: "Get a single contact by its ID or email address.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly publicationId: {
+                readonly type: "string";
+            };
+            readonly idOrEmail: {
+                readonly type: "string";
+                readonly description: "Contact ID or email address.";
+            };
+        };
+        readonly required: readonly ["publicationId", "idOrEmail"];
+    };
+}, {
+    readonly name: "contact.delete";
+    readonly description: "Permanently delete a contact by its ID or email address.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly publicationId: {
+                readonly type: "string";
+            };
+            readonly idOrEmail: {
+                readonly type: "string";
+                readonly description: "Contact ID or email address.";
+            };
+        };
+        readonly required: readonly ["publicationId", "idOrEmail"];
+    };
+}, {
+    readonly name: "contact.get_properties";
+    readonly description: "Read a contact's custom property values.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly publicationId: {
+                readonly type: "string";
+            };
+            readonly contactId: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["publicationId", "contactId"];
+    };
+}, {
+    readonly name: "contact.set_properties";
+    readonly description: "Set a contact's custom property values. Each value references a property by propertyId (from contact_property.list/create).";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly publicationId: {
+                readonly type: "string";
+            };
+            readonly contactId: {
+                readonly type: "string";
+            };
+            readonly values: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly propertyId: {
+                            readonly type: "string";
+                        };
+                        readonly value: {
+                            readonly type: "string";
+                        };
+                    };
+                    readonly required: readonly ["propertyId", "value"];
+                };
+            };
+        };
+        readonly required: readonly ["publicationId", "contactId", "values"];
+    };
+}, {
+    readonly name: "tag.create";
+    readonly description: "Create a tag definition. NOTE: tags cannot yet be assigned to individual contacts via the API — this manages tag definitions only.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly publicationId: {
+                readonly type: "string";
+            };
+            readonly name: {
+                readonly type: "string";
+            };
+            readonly default_subscription: {
+                readonly type: "string";
+                readonly enum: readonly ["opt_in", "opt_out"];
+            };
+            readonly description: {
+                readonly type: "string";
+            };
+            readonly visibility: {
+                readonly type: "string";
+                readonly enum: readonly ["public", "private"];
+            };
+        };
+        readonly required: readonly ["publicationId", "name", "default_subscription"];
+    };
+}, {
+    readonly name: "tag.list";
+    readonly description: "List tag definitions for a publication.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly publicationId: {
+                readonly type: "string";
+            };
+            readonly limit: {
+                readonly type: "number";
+                readonly description: "Max results (1-100, default 20).";
+            };
+        };
+        readonly required: readonly ["publicationId"];
+    };
+}, {
+    readonly name: "tag.update";
+    readonly description: "Update a tag definition's name, description, default subscription, or visibility.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly publicationId: {
+                readonly type: "string";
+            };
+            readonly tagId: {
+                readonly type: "string";
+            };
+            readonly name: {
+                readonly type: "string";
+            };
+            readonly description: {
+                readonly type: "string";
+            };
+            readonly default_subscription: {
+                readonly type: "string";
+                readonly enum: readonly ["opt_in", "opt_out"];
+            };
+            readonly visibility: {
+                readonly type: "string";
+                readonly enum: readonly ["public", "private"];
+            };
+        };
+        readonly required: readonly ["publicationId", "tagId"];
+    };
+}, {
+    readonly name: "tag.delete";
+    readonly description: "Delete a tag definition.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly publicationId: {
+                readonly type: "string";
+            };
+            readonly tagId: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["publicationId", "tagId"];
+    };
+}, {
+    readonly name: "api_key.create";
+    readonly 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 — store it securely. 'full_access' grants all scopes; 'sending_access' grants issue read/write/send only.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly name: {
+                readonly type: "string";
+                readonly description: "Human label for the key (max 50 chars).";
+            };
+            readonly permission: {
+                readonly type: "string";
+                readonly enum: readonly ["full_access", "sending_access"];
+                readonly description: "Defaults to full_access.";
+            };
+            readonly domain_id: {
+                readonly type: "string";
+                readonly description: "Optional publication scope for sending_access.";
+            };
+        };
+        readonly required: readonly ["name"];
+    };
+}, {
+    readonly name: "api_key.list";
+    readonly description: "List the team's API keys (token values are never returned).";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {};
+    };
+}, {
+    readonly name: "api_key.revoke";
+    readonly description: "Revoke (delete) an API key by its ID.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly keyId: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["keyId"];
+    };
+}];
+declare const MCP_RESOURCES: readonly [{
+    readonly uri: "publication://current/brand-guidelines";
+    readonly name: "Brand Guidelines";
+    readonly description: "Publication writing style and visual preferences";
+    readonly mimeType: "application/json";
+}, {
+    readonly uri: "mailtea://capabilities";
+    readonly name: "Mailtea MCP Capabilities";
+    readonly description: "Tool and endpoint capabilities for this MCP runtime";
+    readonly mimeType: "application/json";
+}, {
+    readonly uri: "analytics://current/latest-summary";
+    readonly name: "Latest Analytics Summary";
+    readonly description: "Most recent newsletter engagement snapshot";
+    readonly mimeType: "application/json";
+}];
+declare const MCP_PROMPTS: readonly [{
+    readonly name: "newsletter.draft_from_brief";
+    readonly description: "Create a newsletter draft from a short brief";
+}, {
+    readonly name: "newsletter.subject_line_pack";
+    readonly description: "Generate subject line variants";
+}];
+declare function handleMcpRequest(request: JsonRpcRequest, options?: McpRuntimeOptions): Promise<JsonRpcResponse>;
+
+export { type JsonRpcId, type JsonRpcRequest, type JsonRpcResponse, MCP_PROMPTS, MCP_RESOURCES, MCP_TOOLS, type McpRuntimeOptions, handleMcpRequest };