hollerpost-mcp 0.8.1 → 0.10.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +45 -1
- package/README.md +3 -1
- package/dist/tools.js +215 -9
- package/dist/version.d.ts +1 -1
- package/dist/version.js +1 -1
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,6 +1,50 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
-
## 0.
|
|
3
|
+
## 0.10.0 (2026-11-16)
|
|
4
|
+
|
|
5
|
+
- New `launchpad_domain_set` (`hostname`, `confirm: true`) and
|
|
6
|
+
`launchpad_domain_remove` (`confirm: true`): serve the launch page at the
|
|
7
|
+
business's own subdomain (like join.yourbusiness.com) with one CNAME to
|
|
8
|
+
pages.hollerpost.com. Paid plans only; bare domains are refused.
|
|
9
|
+
`launchpad_get` reports `custom_domain` (address, status, the record to add).
|
|
10
|
+
- Page motion: `page_update` `theme.motion` and `launchpad_update`
|
|
11
|
+
`design.style.motion` take `lively` (the default when unset), `subtle` or
|
|
12
|
+
`off`. Visitors who ask their device for reduced motion always get none.
|
|
13
|
+
|
|
14
|
+
## 0.9.0 (2026-11-16)
|
|
15
|
+
|
|
16
|
+
Retail promo emails (511-style layout) in one call, and the Launchpad advanced editor, offline switch and page design.
|
|
17
|
+
|
|
18
|
+
- New `launchpad_set_offline` (`offline`, `confirm: true`): take the launch
|
|
19
|
+
page offline without deleting it, or put it back online. While offline,
|
|
20
|
+
visitors go to Your page (when published) or hollerpost.com/launchpad/.
|
|
21
|
+
`launchpad_get` now reports `offline`.
|
|
22
|
+
|
|
23
|
+
- New `brand_set_footer`: link buttons (up to 5, full-width outline pills),
|
|
24
|
+
the "Follow us" icon row (`social` handles + `social_icons: true`) and a
|
|
25
|
+
small disclaimer above the address. Address and unsubscribe are always
|
|
26
|
+
added and can't be changed here.
|
|
27
|
+
- New `brand_set_theme`: theme colors (`background`, `surface`, `text`),
|
|
28
|
+
`button_style` (solid | outline), `button_shape` (pill | rounded) and the
|
|
29
|
+
default `info_bar`.
|
|
30
|
+
- `brand_get` returns `theme`, `info_bar`, `footer.links`,
|
|
31
|
+
`footer.disclaimer`, `footer.social_icons` and `social`.
|
|
32
|
+
- `campaign_draft` / `campaign_update` blocks: `image_link` (hero click),
|
|
33
|
+
`cta_repeat: "bottom"`, `layout: "grid-2"` (two-across product cards),
|
|
34
|
+
`sections[].price`, `fine_print`, `info_bar` (or `"off"`) and `theme`.
|
|
35
|
+
The description carries a full example.
|
|
36
|
+
- `campaign_preview` can warn `low_contrast_text` / `low_contrast_button`.
|
|
37
|
+
- `launchpad_update` takes an optional `design`: the launch page built from
|
|
38
|
+
blocks (the dashboard's advanced editor). Blocks: hero, text, image,
|
|
39
|
+
button, list, countdown (launch date), faq, social, divider, spacer and
|
|
40
|
+
exactly one signup block. Page style: background, surface, text, accent
|
|
41
|
+
and button text colors, fonts, button shape and style. The API checks
|
|
42
|
+
plain text, https links, our image host and 4.5:1 contrast; the same
|
|
43
|
+
publish checks run. `design.mode: "simple"` goes back to the simple page
|
|
44
|
+
and keeps the blocks.
|
|
45
|
+
- `launchpad_get` returns `launch_page.design` (or null).
|
|
46
|
+
|
|
47
|
+
## 0.8.1 (2026-11-16)
|
|
4
48
|
|
|
5
49
|
- `mcpName` (`com.hollerpost/mcp`) in package.json and a `server.json` for
|
|
6
50
|
the official MCP registry (GTM-222). No tool changes.
|
package/README.md
CHANGED
|
@@ -114,6 +114,8 @@ If a tool needs a scope the key lacks, the tool answers `insufficient_scope`, na
|
|
|
114
114
|
| `workspace_info` | read | Who this key is: workspace, plan, scopes, brand. Start here |
|
|
115
115
|
| `brand_get` | read | Brand settings and writing voice |
|
|
116
116
|
| `brand_set_voice` | draft | Save the brand voice notes (replaces the old text) |
|
|
117
|
+
| `brand_set_footer` | draft | Save the footer every email carries: link buttons, Follow us icons, disclaimer |
|
|
118
|
+
| `brand_set_theme` | draft | Save the email look: colors, solid or outline and pill or rounded buttons, info bar |
|
|
117
119
|
| `templates_list` | read | Templates and the content blocks each accepts |
|
|
118
120
|
| `email_image_upload` | draft | Store an image (from a URL or the file) for use in an email; returns its URL |
|
|
119
121
|
| `email_image_upload_link` | draft | A one-time page where the person uploads pictures from their device |
|
|
@@ -150,7 +152,7 @@ If a tool needs a scope the key lacks, the tool answers `insufficient_scope`, na
|
|
|
150
152
|
| `page_get` | read | Read Your page, links, calendar events and plan settings |
|
|
151
153
|
| `page_update` | draft | Save page fields via `updates`, including waitlist fields; publication needs `confirm_publish: true` after the person approves and may be held for review |
|
|
152
154
|
| `launchpad_get` | read | Read confirmed/this-week/pending/queued counts, confirmation allowance, list size vs plan emails, share URL and mode |
|
|
153
|
-
| `launchpad_update` | draft | Save waitlist headline/pitch, count visibility, launch note, primary link and waitlist/standard mode as a draft; does not publish |
|
|
155
|
+
| `launchpad_update` | draft | Save waitlist headline/pitch, count visibility, launch note, primary link and waitlist/standard mode as a draft, or the whole page as blocks (`design`, the advanced editor); does not publish |
|
|
154
156
|
| `launchpad_go_live` | draft | Request live mode and publication after the person approves the launch note and primary link (`confirm: true`); reports review holds plainly |
|
|
155
157
|
| `page_link_add` | draft | Add a HTTPS link via `link` (max 30) |
|
|
156
158
|
| `page_link_update` | draft | Update a link by `id` and `updates` |
|
package/dist/tools.js
CHANGED
|
@@ -60,6 +60,35 @@ const sectionSchema = z
|
|
|
60
60
|
image_position: z.enum(['top', 'left', 'right']).optional().describe('top (default): image above the copy. left or right: image beside the copy on wide screens, stacked on phones.'),
|
|
61
61
|
cta_text: z.string().max(40).optional().describe('Button label for this section.'),
|
|
62
62
|
cta_url: https.max(2000).optional().describe('Button link for this section.'),
|
|
63
|
+
price: z.string().max(40).optional().describe('Price line, for example "$129 (was $179)". Shown under the heading; with layout "grid-2" it sits on the product card.'),
|
|
64
|
+
})
|
|
65
|
+
.strict();
|
|
66
|
+
const hexColor = z.string().regex(/^#[0-9a-fA-F]{6}$/, 'Use a hex color like #111827.');
|
|
67
|
+
const infoBarSchema = z
|
|
68
|
+
.union([
|
|
69
|
+
z
|
|
70
|
+
.object({
|
|
71
|
+
text: z.string().min(1).max(120).describe('Short line, for example "Free shipping on orders over $99".'),
|
|
72
|
+
url: https.max(2000).optional().describe('Where a click on the bar goes (https URL).'),
|
|
73
|
+
})
|
|
74
|
+
.strict(),
|
|
75
|
+
z.literal('off'),
|
|
76
|
+
])
|
|
77
|
+
.describe('Dark band across the top of the email. An object sets it for this email (replacing the brand default); "off" hides the brand default for this email.');
|
|
78
|
+
const themeSchema = z
|
|
79
|
+
.object({
|
|
80
|
+
background: hexColor.optional().describe('Page color around the email.'),
|
|
81
|
+
surface: hexColor.optional().describe('Email card color. A dark surface gets light text and light outline buttons automatically.'),
|
|
82
|
+
text: hexColor.optional().describe('Body text color. Needs at least 4.5:1 contrast with surface (campaign_preview warns low_contrast_text).'),
|
|
83
|
+
button_style: z.enum(['solid', 'outline']).optional().describe('solid: filled with the brand color. outline: border and label only, the retail look.'),
|
|
84
|
+
button_shape: z.enum(['pill', 'rounded']).optional().describe('pill: fully round ends. rounded: the brand corner radius.'),
|
|
85
|
+
})
|
|
86
|
+
.strict();
|
|
87
|
+
const SOCIAL_NETWORKS = ['instagram', 'facebook', 'x', 'linkedin', 'youtube', 'tiktok', 'threads', 'pinterest'];
|
|
88
|
+
const footerLinkSchema = z
|
|
89
|
+
.object({
|
|
90
|
+
label: z.string().min(1).max(40).describe('Button text, for example "Shop men\u2019s" or "Find your store". Shown in capitals.'),
|
|
91
|
+
url: https.max(2000).describe('Button link (https URL).'),
|
|
63
92
|
})
|
|
64
93
|
.strict();
|
|
65
94
|
const blocksSchema = z
|
|
@@ -78,6 +107,12 @@ const blocksSchema = z
|
|
|
78
107
|
.max(8)
|
|
79
108
|
.optional()
|
|
80
109
|
.describe('Optional: up to 8 sections after body_md, each with its own sub-heading, image, copy and button, divided by a line. Use for a promotion with several products or a newsletter with several stories. Each needs at least a heading, body_md or image_url. Up to 20 images per email in total.'),
|
|
110
|
+
image_link: https.max(2000).optional().describe('Where a click on the hero image goes (https URL). Defaults to cta_url.'),
|
|
111
|
+
cta_repeat: z.literal('bottom').optional().describe('"bottom": show the main button right after body_md AND again after the sections (retail promo style). Needs cta_text, cta_url and sections.'),
|
|
112
|
+
layout: z.enum(['stack', 'grid-2']).optional().describe('How sections show. stack (default): one per row. grid-2: product cards two across (image, heading, price, short copy, button), stacked on phones.'),
|
|
113
|
+
fine_print: z.string().max(1500).optional().describe('Offer terms in small print at the very end, for example "Ends Sunday 11:59pm. Not valid with other offers." Plain text with **bold**, *italic* and [links](https://...).'),
|
|
114
|
+
info_bar: infoBarSchema.optional(),
|
|
115
|
+
theme: themeSchema.optional().describe('This email\u2019s colors and buttons; anything left out follows the brand (brand_set_theme).'),
|
|
81
116
|
})
|
|
82
117
|
// Templates may add more text blocks later; accept them as strings.
|
|
83
118
|
.catchall(z.string())
|
|
@@ -247,10 +282,42 @@ const pageSectionSchema = z.object({
|
|
|
247
282
|
image_url: z.string().max(2048).optional().describe('Optional picture. Must be an https://images.hollerpost.com URL: store it with email_image_upload first.'),
|
|
248
283
|
image_alt: z.string().max(200).optional().describe('Required with image_url: what the picture shows.'),
|
|
249
284
|
}).strict();
|
|
285
|
+
// Advanced Launchpad editor: the launch page as blocks. The API checks the
|
|
286
|
+
// same rules (src/lib/page/design.js), including contrast and the image host.
|
|
287
|
+
const designText = (max) => z.string().max(max);
|
|
288
|
+
const designImage = z.string().max(2048).describe('A picture stored with email_image_upload (https://images.hollerpost.com/...). Other hosts are refused.');
|
|
289
|
+
const designBlockSchema = z.discriminatedUnion('type', [
|
|
290
|
+
z.object({ type: z.literal('hero'), id: z.string().optional(), headline: designText(120).min(1).describe('The page headline (the only h1).'), text: designText(600).optional().describe('Plain text under the headline. Blank line = new paragraph.'), image_url: designImage.optional(), image_alt: designText(200).optional().describe('Required with image_url.'), show_logo: z.boolean().optional().describe('Show the page logo (avatar_url) above the headline.') }).strict(),
|
|
291
|
+
z.object({ type: z.literal('text'), id: z.string().optional(), heading: designText(120).optional(), body: designText(2000).min(1).describe('Plain text. No HTML or markdown links.') }).strict(),
|
|
292
|
+
z.object({ type: z.literal('image'), id: z.string().optional(), image_url: designImage, image_alt: designText(200).min(1).describe('What the picture shows.'), link_url: z.string().max(2048).optional().describe('Optional https link when the picture is tapped.'), caption: designText(200).optional() }).strict(),
|
|
293
|
+
z.object({ type: z.literal('button'), id: z.string().optional(), label: designText(60).min(1), url: z.string().max(2048).describe('Full https link. URL shorteners are refused.') }).strict(),
|
|
294
|
+
z.object({ type: z.literal('list'), id: z.string().optional(), heading: designText(120).optional(), style: z.enum(['bullets', 'checks', 'cards']).optional(), items: z.array(z.object({ title: designText(80).optional(), text: designText(300).optional() }).strict()).min(1).max(12) }).strict(),
|
|
295
|
+
z.object({ type: z.literal('countdown'), id: z.string().optional(), heading: designText(80).optional().describe('Default "Launching".'), date: z.string().regex(/^\d{4}-\d{2}-\d{2}$/).describe('Launch date, YYYY-MM-DD.'), show_days: z.boolean().optional().describe('Also show "N days to go".') }).strict(),
|
|
296
|
+
z.object({ type: z.literal('faq'), id: z.string().optional(), heading: designText(120).optional(), items: z.array(z.object({ question: designText(160).min(1), answer: designText(1000).min(1) }).strict()).min(1).max(12) }).strict(),
|
|
297
|
+
z.object({ type: z.literal('social'), id: z.string().optional(), items: z.array(z.object({ network: z.enum(['instagram', 'tiktok', 'facebook', 'youtube', 'x', 'threads', 'bluesky', 'linkedin', 'pinterest', 'snapchat', 'twitch', 'discord', 'whatsapp', 'spotify', 'website']), url: z.string().describe('Handle or full profile link.') }).strict()).min(1).max(15) }).strict(),
|
|
298
|
+
z.object({ type: z.literal('divider'), id: z.string().optional() }).strict(),
|
|
299
|
+
z.object({ type: z.literal('spacer'), id: z.string().optional(), size: z.enum(['sm', 'md', 'lg']).optional() }).strict(),
|
|
300
|
+
z.object({ type: z.literal('signup'), id: z.string().optional(), heading: designText(120).optional().describe('Default: "Join <page title>".'), text: designText(300).optional(), button_label: designText(40).optional() }).strict(),
|
|
301
|
+
]);
|
|
302
|
+
const hex = z.string().regex(/^#[0-9a-fA-F]{6}$/);
|
|
303
|
+
// Page motion (11/16). Must match MOTION_LEVELS in the API's src/lib/page/validation.js.
|
|
304
|
+
const pageMotion = z.enum(['lively', 'subtle', 'off']).optional().describe('How much the page moves. lively (default): gentle entrance, button lift, signup shine, a small celebration on joining. subtle: soft fade and small hover lifts. off: no movement. Visitors who ask their device for reduced motion always get none.');
|
|
305
|
+
const launchDesignSchema = z.object({
|
|
306
|
+
version: z.literal(1).optional(),
|
|
307
|
+
mode: z.enum(['advanced', 'simple']).optional().describe('advanced (default) shows the blocks. simple goes back to the simple page and keeps these blocks saved.'),
|
|
308
|
+
style: z.object({
|
|
309
|
+
backgroundColor: hex.optional(), surfaceColor: hex.optional().describe('Boxes and cards (signup box, FAQ, list cards).'), textColor: hex.optional(),
|
|
310
|
+
accentColor: hex.optional().describe('Buttons.'), buttonTextColor: hex.optional(),
|
|
311
|
+
fontFamily: z.enum(PAGE_BODY_FONTS).optional(), headingFont: z.enum(PAGE_HEADING_FONTS).optional().describe('body means the same as fontFamily.'),
|
|
312
|
+
buttonShape: z.enum(['square', 'rounded', 'pill']).optional(), buttonStyle: z.enum(['solid', 'outline']).optional(),
|
|
313
|
+
motion: pageMotion,
|
|
314
|
+
}).strict().optional().describe('Page look. Text on background and on surface, and button text on accent, each need 4.5:1 contrast (the API refuses less).'),
|
|
315
|
+
blocks: z.array(designBlockSchema).max(30).describe('The whole page, top to bottom. Exactly one signup block (required). At most one hero, one countdown and one social block. Plain text only; links https only; pictures from images.hollerpost.com with alt text. Keep ids from launchpad_get to keep blocks.'),
|
|
316
|
+
}).strict();
|
|
250
317
|
// Your page only (L-45). Waitlist fields live on the launch page: launchpad_update.
|
|
251
318
|
const pageUpdateSchema = z.object({
|
|
252
319
|
title: z.string().max(120).optional(), tagline: z.string().max(240).optional(), avatar_url: z.union([z.string().max(2048), z.null()]).optional(),
|
|
253
|
-
theme: z.object({ brandColor: z.string().optional(), backgroundColor: z.string().optional(), textColor: z.string().optional(), buttonTextColor: z.string().optional(), fontFamily: z.enum(PAGE_BODY_FONTS).optional().describe('Body text font.'), buttonRadius: z.number().int().min(0).max(40).optional(), linkStyle: z.enum(['button', 'outline', 'pill', 'todo', 'checklist', 'microchip', 'clouds', 'ticket']).optional().describe('How the page links look. button: solid buttons (default). outline: outlined buttons. pill: round pills with an arrow. todo: to-do list rows with an empty box. checklist: rows with a ticked box. microchip: cyberpunk chips with notched corners. clouds: puffy cloud shapes. ticket: admission tickets with notched sides. Colors come from the theme; the main link and signup button stay solid.'), accentColor: z.string().regex(/^#[0-9a-fA-F]{6}$/).optional().describe('Six-digit hex accent for background patterns and details.'), backgroundStyle: z.enum(['solid', 'gradient', 'glow', 'dots', 'grid', 'lined', 'stripes', 'checker', 'sunburst']).optional().describe('Background behind the page. Text keeps 4.5:1 contrast against the pattern too (the API checks).'), headingFont: z.enum(PAGE_HEADING_FONTS).optional().describe('Headline font. body means the same as fontFamily.'), layout: z.enum(['centered', 'left', 'card']).optional().describe('centered, left aligned, or the page on a card over the background.') }).describe('The whole look. Send every field you want to keep: the theme replaces the saved one. A theme without accentColor, backgroundStyle, headingFont and layout keeps the classic look.').optional(),
|
|
320
|
+
theme: z.object({ brandColor: z.string().optional(), backgroundColor: z.string().optional(), textColor: z.string().optional(), buttonTextColor: z.string().optional(), fontFamily: z.enum(PAGE_BODY_FONTS).optional().describe('Body text font.'), buttonRadius: z.number().int().min(0).max(40).optional(), linkStyle: z.enum(['button', 'outline', 'pill', 'todo', 'checklist', 'microchip', 'clouds', 'ticket']).optional().describe('How the page links look. button: solid buttons (default). outline: outlined buttons. pill: round pills with an arrow. todo: to-do list rows with an empty box. checklist: rows with a ticked box. microchip: cyberpunk chips with notched corners. clouds: puffy cloud shapes. ticket: admission tickets with notched sides. Colors come from the theme; the main link and signup button stay solid.'), accentColor: z.string().regex(/^#[0-9a-fA-F]{6}$/).optional().describe('Six-digit hex accent for background patterns and details.'), backgroundStyle: z.enum(['solid', 'gradient', 'glow', 'dots', 'grid', 'lined', 'stripes', 'checker', 'sunburst']).optional().describe('Background behind the page. Text keeps 4.5:1 contrast against the pattern too (the API checks).'), headingFont: z.enum(PAGE_HEADING_FONTS).optional().describe('Headline font. body means the same as fontFamily.'), layout: z.enum(['centered', 'left', 'card']).optional().describe('centered, left aligned, or the page on a card over the background.'), motion: pageMotion }).describe('The whole look. Send every field you want to keep: the theme replaces the saved one. A theme without accentColor, backgroundStyle, headingFont and layout keeps the classic look.').optional(),
|
|
254
321
|
show_badge: z.boolean().optional(), signup_form_id: z.string().uuid().nullable().optional(),
|
|
255
322
|
socials: z.array(z.object({ network: z.enum(['instagram', 'tiktok', 'facebook', 'youtube', 'x', 'threads', 'bluesky', 'linkedin', 'pinterest', 'snapchat', 'twitch', 'discord', 'whatsapp', 'spotify', 'website']), url: z.string().describe('The handle (like yourbusiness) or the full profile link. Saved as the full https link. WhatsApp takes the number with country code.') })).max(15).optional(),
|
|
256
323
|
info: z.object({ website: z.union([z.string().max(2048), z.null()]).optional(), phone: z.string().optional(), email: z.string().optional(), address_mode: z.enum(['none', 'city', 'full']).optional(), hours: z.string().optional() }).optional(),
|
|
@@ -258,6 +325,26 @@ const pageUpdateSchema = z.object({
|
|
|
258
325
|
show_events: z.boolean().optional(), published: z.boolean().optional(),
|
|
259
326
|
}).strict();
|
|
260
327
|
const PAGE_DESTRUCTIVE = { ...WRITE_IDEMPOTENT, destructiveHint: true };
|
|
328
|
+
const at = (obj, path) => path.split('.').reduce((o, k) => get(o, k), obj);
|
|
329
|
+
// The launch page's own address (join.acme.com), when it has one.
|
|
330
|
+
function customAddressLead(data) {
|
|
331
|
+
const host = at(data, 'custom_domain.hostname');
|
|
332
|
+
if (!host)
|
|
333
|
+
return '';
|
|
334
|
+
const status = at(data, 'custom_domain.status');
|
|
335
|
+
const fix = at(data, 'custom_domain.error_message');
|
|
336
|
+
return ` Own address: ${host} (${status ?? 'unknown'})${status === 'live' ? '' : `; CNAME ${at(data, 'custom_domain.record.host') ?? host} -> ${at(data, 'custom_domain.record.value') ?? ''}`}${fix ? `. ${fix}` : ''}.`;
|
|
337
|
+
}
|
|
338
|
+
const domainLead = (data) => {
|
|
339
|
+
const host = at(data, 'domain.hostname');
|
|
340
|
+
if (!host)
|
|
341
|
+
return 'The launch page has no own address.';
|
|
342
|
+
const status = at(data, 'domain.status');
|
|
343
|
+
if (status === 'live')
|
|
344
|
+
return `The launch page is live at https://${host}.`;
|
|
345
|
+
const fix = at(data, 'domain.error_message');
|
|
346
|
+
return `Saved ${host}; status ${status}. ${fix ? `${fix} ` : ''}The person adds this DNS record: CNAME, host ${at(data, 'domain.record.host')}, value ${at(data, 'domain.record.value')}. No other record is needed. Check again later with launchpad_get.`;
|
|
347
|
+
};
|
|
261
348
|
function launchpadPublicationLead(data) {
|
|
262
349
|
const status = get(data, 'moderation_status');
|
|
263
350
|
if (get(data, 'pending_review') === true || status === 'pending_review' || status === 'review_pending' || status === 'rejected' || status === 'unpublished') {
|
|
@@ -271,17 +358,17 @@ function launchpadPublicationLead(data) {
|
|
|
271
358
|
export const TOOLS = [
|
|
272
359
|
defineTool({
|
|
273
360
|
name: 'launchpad_get', title: 'Get Launchpad', scope: 'read',
|
|
274
|
-
description: 'Read the Launchpad card: confirmed_signups, emailable_subscribers, awaiting_confirmation, confirmed this week and queued confirmations, confirmation allowance, list size versus plan emails, share URL, launch_url, main_page and the launch page\'s saved settings (launch_page: launch note, first button, published). The launch page is separate from Your page; main_page says which one hollerpost.com/@handle shows.',
|
|
361
|
+
description: 'Read the Launchpad card: confirmed_signups, emailable_subscribers, awaiting_confirmation, confirmed this week and queued confirmations, confirmation allowance, list size versus plan emails, share URL, launch_url, main_page, offline (true while the owner has taken the launch page offline) and the launch page\'s saved settings (launch_page: launch note, first button, published, offline, design: the advanced editor blocks or null). The launch page is separate from Your page; main_page says which one hollerpost.com/@handle shows. custom_domain (when the feature is on): the launch page\'s own address, its status (waiting_dns, securing, live, error), the fix for an error and the CNAME record to add.',
|
|
275
362
|
input: {}, annotations: READ, untrusted: true,
|
|
276
363
|
run: async (api) => {
|
|
277
364
|
const data = await api.request('GET', '/launchpad');
|
|
278
|
-
return { lead: `Launchpad: confirmed_signups=${get(data, 'confirmed_signups') ?? 'unavailable'}, emailable_subscribers=${get(data, 'emailable_subscribers') ?? 'unavailable'}, awaiting_confirmation=${get(data, 'awaiting_confirmation') ?? 'unavailable'}, main_page=${get(data, 'main_page') ?? 'page'}
|
|
365
|
+
return { lead: `Launchpad: confirmed_signups=${get(data, 'confirmed_signups') ?? 'unavailable'}, emailable_subscribers=${get(data, 'emailable_subscribers') ?? 'unavailable'}, awaiting_confirmation=${get(data, 'awaiting_confirmation') ?? 'unavailable'}, main_page=${get(data, 'main_page') ?? 'page'}, offline=${get(data, 'offline') === true}.${customAddressLead(data)}`, data };
|
|
279
366
|
},
|
|
280
367
|
}),
|
|
281
368
|
defineTool({
|
|
282
369
|
name: 'launchpad_update', title: 'Update Launchpad draft', scope: 'draft',
|
|
283
|
-
description: 'Save the launch page\'s headline, pitch, count visibility, launch note, first button (a link or Your page) or mode (waitlist, to flip back from live). Omitted fields stay unchanged. Saves a draft only, including when an older approved page is public. Does not publish. Your page is not changed. Use launchpad_get to read the saved launch note and first button before asking the person to go live.',
|
|
284
|
-
input: { ...launchpadFields, mode: z.enum(['waitlist']).optional() },
|
|
370
|
+
description: 'Save the launch page\'s headline, pitch, count visibility, launch note, first button (a link or Your page) or mode (waitlist, to flip back from live). Optional design: build the page from blocks (advanced editor): hero, text, image, button, list, countdown (launch date), faq, social, divider, spacer and exactly one signup block. design replaces the saved design; read launchpad_get (launch_page.design) first. design.mode simple returns to the simple page and keeps the blocks. Omitted fields stay unchanged. Saves a draft only, including when an older approved page is public. Does not publish; the same automatic checks run on publish. Your page is not changed. Use launchpad_get to read the saved launch note and first button before asking the person to go live.',
|
|
371
|
+
input: { ...launchpadFields, mode: z.enum(['waitlist']).optional(), design: launchDesignSchema.optional().describe('Advanced editor design. Example: {"style":{"accentColor":"#C2410C"},"blocks":[{"type":"hero","headline":"Fresh loaves are coming","text":"Sourdough on Elm Street."},{"type":"countdown","date":"2026-12-06","show_days":true},{"type":"signup","button_label":"Save my spot"},{"type":"faq","items":[{"question":"Where?","answer":"12 Elm Street."}]}]}') },
|
|
285
372
|
annotations: WRITE_IDEMPOTENT, untrusted: true,
|
|
286
373
|
run: async (api, args) => {
|
|
287
374
|
const body = Object.fromEntries(Object.entries(args).filter(([, v]) => v !== undefined));
|
|
@@ -293,7 +380,7 @@ export const TOOLS = [
|
|
|
293
380
|
}),
|
|
294
381
|
defineTool({
|
|
295
382
|
name: 'launchpad_go_live', title: 'Launchpad go live', scope: 'draft',
|
|
296
|
-
description: 'Switch the launch page to live mode and request publication after automatic checks. First use launchpad_get, show the person the saved launch note and primary link (the first button: its label and where it goes, a link or Your page), and wait for a clear yes. Requires confirm: true after that approval and a claimed handle with an enabled safe HTTPS primary link or primary_target page. A pending_review or review_pending hold is not live: explain owner_reason, do not retry or bypass review. Sends no campaign.',
|
|
383
|
+
description: 'Switch the launch page to live mode and request publication after automatic checks. First use launchpad_get, show the person the saved launch note and primary link (the first button: its label and where it goes, a link or Your page), and wait for a clear yes. Requires confirm: true after that approval and a claimed handle with an enabled safe HTTPS primary link or primary_target page. A pending_review or review_pending hold is not live: explain owner_reason, do not retry or bypass review. If launchpad_get shows offline: true, the page stays offline until launchpad_set_offline with offline: false. Sends no campaign.',
|
|
297
384
|
input: { confirm: z.literal(true).describe('true only after the person saw the launch note and primary link and approved going live.') },
|
|
298
385
|
annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: false, openWorldHint: true }, untrusted: true,
|
|
299
386
|
run: async (api, { confirm }) => {
|
|
@@ -303,6 +390,45 @@ export const TOOLS = [
|
|
|
303
390
|
return { lead: launchpadPublicationLead(data), data };
|
|
304
391
|
},
|
|
305
392
|
}),
|
|
393
|
+
defineTool({
|
|
394
|
+
name: 'launchpad_domain_set', title: 'Set launch page address', scope: 'draft',
|
|
395
|
+
description: 'Show the launch page at the business\'s own subdomain, like join.yourbusiness.com (never a bare domain like yourbusiness.com). One address per workspace. Ask the person first and pass confirm: true after their yes. Returns the one CNAME record they add at their DNS host and the status (waiting_dns, securing, live, error). Their DNS is theirs: never ask for a DNS login. Returns not_available while the feature is off.',
|
|
396
|
+
input: {
|
|
397
|
+
hostname: z.string().min(4).max(253).describe('The subdomain, like join.yourbusiness.com.'),
|
|
398
|
+
confirm: z.literal(true).describe('true only after the person approved using this address.'),
|
|
399
|
+
},
|
|
400
|
+
annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true }, untrusted: true,
|
|
401
|
+
run: async (api, { hostname, confirm }) => {
|
|
402
|
+
if (confirm !== true)
|
|
403
|
+
throw new InputError('Setting the address requires confirm: true after the person approves it.');
|
|
404
|
+
const data = await api.request('POST', '/launchpad/domain', { body: { hostname }, headers: { 'X-Hollerpost-Confirm': 'domain' } });
|
|
405
|
+
return { lead: domainLead(data), data };
|
|
406
|
+
},
|
|
407
|
+
}),
|
|
408
|
+
defineTool({
|
|
409
|
+
name: 'launchpad_domain_remove', title: 'Remove launch page address', scope: 'draft',
|
|
410
|
+
description: 'Stop showing the launch page at its own address. The hollerpost.com address keeps working. Ask for confirmation first; requires confirm: true.',
|
|
411
|
+
input: { confirm: z.literal(true).describe('true only after the person approved removing the address.') },
|
|
412
|
+
annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: true },
|
|
413
|
+
run: async (api, { confirm }) => {
|
|
414
|
+
if (confirm !== true)
|
|
415
|
+
throw new InputError('Removing the address requires confirm: true after the person approves it.');
|
|
416
|
+
const data = await api.request('DELETE', '/launchpad/domain', { headers: { 'X-Hollerpost-Confirm': 'domain' } });
|
|
417
|
+
return { lead: 'Removed. The launch page no longer shows at its own address; the person can delete the CNAME record.', data };
|
|
418
|
+
},
|
|
419
|
+
}),
|
|
420
|
+
defineTool({
|
|
421
|
+
name: 'launchpad_set_offline', title: 'Take Launchpad page offline or back online', scope: 'draft',
|
|
422
|
+
description: 'Take the launch page offline (offline: true) or put it back online (offline: false). Offline is not deleting: the page, its design and its signups stay. While offline, visitors to the launch page address are sent to Your page if it is published, otherwise to hollerpost.com. Putting it back online shows the last approved page; it does not republish. Ask the person first; requires confirm: true after their yes.',
|
|
423
|
+
input: { offline: z.boolean().describe('true to take the launch page offline, false to put it back online.'), confirm: z.literal(true).describe('true only after the person approved this change.') },
|
|
424
|
+
annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: true },
|
|
425
|
+
run: async (api, { offline, confirm }) => {
|
|
426
|
+
if (confirm !== true)
|
|
427
|
+
throw new InputError('Taking the page offline or back online requires confirm: true after the person approves.');
|
|
428
|
+
const data = await api.request('PUT', '/page/offline', { body: { offline }, headers: { 'X-Hollerpost-Confirm': 'publish' } });
|
|
429
|
+
return { lead: get(data, 'offline') ? 'The launch page is offline. Visitors are sent to Your page or hollerpost.com until it is back online.' : 'The launch page is back online.', data };
|
|
430
|
+
},
|
|
431
|
+
}),
|
|
306
432
|
defineTool({ name: 'page_get', title: 'Get Your page', scope: 'read', description: 'Read Your page, links, events, handle and plan settings, plus main_page (which page hollerpost.com/@handle shows: page or launch), publicUrl and pageUrl (/@handle/links). An unsaved draft from the brand kit is returned if no page exists. The launch page is read with launchpad_get.', input: {}, annotations: READ, untrusted: true,
|
|
307
433
|
run: async (api) => { const data = await api.request('GET', '/page'); return { lead: `Your page and workspace settings. main_page=${get(data, 'main_page') ?? 'page'}.`, data }; } }),
|
|
308
434
|
defineTool({ name: 'page_update', title: 'Update Your page', scope: 'draft', description: 'Update Your page fields (not the launch page: use launchpad_update). Arrays replace existing values. Publishing (published: true) needs the person\'s approval and confirm_publish: true. Without it, edits to a page that is already published are saved as a draft and the public page keeps its approved version. Automatic checks may hold changes for review; inspect pending_review, moderation_status and owner_reason before claiming publication. Requires a claimed handle; Free must show the badge. HTTPS destinations and contrast are enforced by the API.', input: { updates: pageUpdateSchema, confirm_publish: z.literal(true).optional().describe('true only after the person explicitly approved publishing; required whenever this call publishes.') }, annotations: WRITE_IDEMPOTENT, untrusted: true,
|
|
@@ -349,7 +475,7 @@ export const TOOLS = [
|
|
|
349
475
|
name: 'brand_get',
|
|
350
476
|
title: 'Get brand',
|
|
351
477
|
scope: 'read',
|
|
352
|
-
description: 'Returns the brand settings: workspace and from name, reply-to, logo, colors, footer address, the saved writing voice and the sending domain status. Free and read only. Read this before writing any campaign copy and follow the voice exactly.',
|
|
478
|
+
description: 'Returns the brand settings: workspace and from name, reply-to, logo, colors, the theme (background, surface, text, button_style, button_shape), the default info_bar, the footer (address, link buttons, disclaimer, social_icons), social profile links, the saved writing voice and the sending domain status. Free and read only. Read this before writing any campaign copy and follow the voice exactly.',
|
|
353
479
|
input: {},
|
|
354
480
|
annotations: READ,
|
|
355
481
|
run: async (api) => {
|
|
@@ -371,6 +497,82 @@ export const TOOLS = [
|
|
|
371
497
|
return { lead: 'Brand voice saved.', data };
|
|
372
498
|
},
|
|
373
499
|
}),
|
|
500
|
+
defineTool({
|
|
501
|
+
name: 'brand_set_footer',
|
|
502
|
+
title: 'Save email footer',
|
|
503
|
+
scope: 'draft',
|
|
504
|
+
description: 'Saves the footer every email carries, above the mailing address and unsubscribe link (those two are always added and cannot be changed here): up to 5 full-width link buttons (links, for example Shop men\u2019s, Find your store), the "Follow us" social icon row (social handles plus social_icons: true), and a small disclaimer (pricing or legal note). Fields you leave out stay as they are; links: [] removes the buttons, disclaimer: "" removes the note. Applies to every email sent after saving, including scheduled ones that have not gone out yet. Uses no quota and sends nothing. Read brand_get first and only save what the person approved. ' +
|
|
505
|
+
'Example: {"links": [{"label": "Shop men\u2019s", "url": "https://shop.example/men"}, {"label": "Find your store", "url": "https://shop.example/stores"}], "social": {"instagram": "shopexample", "youtube": "shopexample"}, "social_icons": true, "disclaimer": "Prices may differ in stores."}',
|
|
506
|
+
input: {
|
|
507
|
+
links: z.array(footerLinkSchema).max(5).optional().describe('Footer link buttons, top to bottom. Replaces the current list.'),
|
|
508
|
+
disclaimer: z.string().max(1500).optional().describe('Small print above the address, for example pricing, shipping or legal notes. **bold**, *italic* and [links](https://...) work. "" removes it.'),
|
|
509
|
+
social: z
|
|
510
|
+
.object(Object.fromEntries(SOCIAL_NETWORKS.map((n) => [n, z.string().max(300).optional()])))
|
|
511
|
+
.strict()
|
|
512
|
+
.optional()
|
|
513
|
+
.describe('Social profiles: a handle ("shopexample", "@shopexample") or the profile link. "" removes one. These are the same profiles as Settings > Brand.'),
|
|
514
|
+
social_icons: z.boolean().optional().describe('true: show the profiles as a "Follow us" row of icons. false: plain text links (the older look).'),
|
|
515
|
+
},
|
|
516
|
+
annotations: WRITE_IDEMPOTENT,
|
|
517
|
+
run: async (api, args) => {
|
|
518
|
+
const footer = {};
|
|
519
|
+
if (args.links !== undefined)
|
|
520
|
+
footer.links = args.links;
|
|
521
|
+
if (args.disclaimer !== undefined)
|
|
522
|
+
footer.disclaimer = args.disclaimer;
|
|
523
|
+
if (args.social_icons !== undefined)
|
|
524
|
+
footer.social_icons = args.social_icons;
|
|
525
|
+
const body = {};
|
|
526
|
+
if (Object.keys(footer).length)
|
|
527
|
+
body.footer = footer;
|
|
528
|
+
if (args.social !== undefined)
|
|
529
|
+
body.social = args.social;
|
|
530
|
+
if (!Object.keys(body).length)
|
|
531
|
+
throw new InputError('Nothing to save: pass links, disclaimer, social or social_icons.');
|
|
532
|
+
const data = await api.request('PATCH', '/brand', { body });
|
|
533
|
+
return { lead: 'Email footer saved. It shows in every email sent from now on.', data };
|
|
534
|
+
},
|
|
535
|
+
}),
|
|
536
|
+
defineTool({
|
|
537
|
+
name: 'brand_set_theme',
|
|
538
|
+
title: 'Save email look',
|
|
539
|
+
scope: 'draft',
|
|
540
|
+
description: 'Saves the default look of every email: theme colors (background, surface, text), buttons (button_style solid or outline, button_shape pill or rounded) and the info bar, a dark band across the top (for example free shipping). A single campaign can override any of these with blocks.theme and blocks.info_bar. Fields you leave out stay as they are; info_bar: null removes the bar; a color "" goes back to the default. Text needs 4.5:1 contrast with the surface; campaign_preview warns when it does not. Uses no quota and sends nothing. Only save what the person approved. ' +
|
|
541
|
+
'Example: {"theme": {"surface": "#ffffff", "text": "#27272a", "button_style": "outline", "button_shape": "pill"}, "info_bar": {"text": "Free shipping on orders over $99", "url": "https://shop.example/shipping"}}',
|
|
542
|
+
input: {
|
|
543
|
+
theme: z
|
|
544
|
+
.object({
|
|
545
|
+
background: hexColor.or(z.literal('')).optional().describe('Page color around the email.'),
|
|
546
|
+
surface: hexColor.or(z.literal('')).optional().describe('Email card color.'),
|
|
547
|
+
text: hexColor.or(z.literal('')).optional().describe('Body text color.'),
|
|
548
|
+
button_style: z.enum(['solid', 'outline']).nullable().optional().describe('solid or outline; null goes back to solid.'),
|
|
549
|
+
button_shape: z.enum(['pill', 'rounded']).nullable().optional().describe('pill or rounded; null goes back to the brand radius.'),
|
|
550
|
+
})
|
|
551
|
+
.strict()
|
|
552
|
+
.optional(),
|
|
553
|
+
info_bar: z
|
|
554
|
+
.object({
|
|
555
|
+
text: z.string().min(1).max(120).describe('Short line, for example "Free shipping on orders over $99".'),
|
|
556
|
+
url: https.max(2000).optional().describe('Where a click on the bar goes.'),
|
|
557
|
+
})
|
|
558
|
+
.strict()
|
|
559
|
+
.nullable()
|
|
560
|
+
.optional()
|
|
561
|
+
.describe('Default info bar for every email, or null to remove it.'),
|
|
562
|
+
},
|
|
563
|
+
annotations: WRITE_IDEMPOTENT,
|
|
564
|
+
run: async (api, args) => {
|
|
565
|
+
const body = {};
|
|
566
|
+
if (args.theme !== undefined)
|
|
567
|
+
body.theme = args.theme;
|
|
568
|
+
if (args.info_bar !== undefined)
|
|
569
|
+
body.info_bar = args.info_bar;
|
|
570
|
+
if (!Object.keys(body).length)
|
|
571
|
+
throw new InputError('Nothing to save: pass theme or info_bar.');
|
|
572
|
+
const data = await api.request('PATCH', '/brand', { body });
|
|
573
|
+
return { lead: 'Email look saved. It applies to every email from now on unless a campaign overrides it.', data };
|
|
574
|
+
},
|
|
575
|
+
}),
|
|
374
576
|
defineTool({
|
|
375
577
|
name: 'templates_list',
|
|
376
578
|
title: 'List templates',
|
|
@@ -510,7 +712,9 @@ export const TOOLS = [
|
|
|
510
712
|
name: 'campaign_draft',
|
|
511
713
|
title: 'Draft campaign',
|
|
512
714
|
scope: 'draft',
|
|
513
|
-
description: 'Creates a campaign as a DRAFT. Nothing is sent and no quota is used. Before calling: read brand_get for the voice, pick a template from templates_list, and pick the audience from segments_list. You fill the content blocks; Hollerpost renders the email with the brand header, footer and unsubscribe link. Optionally ask one survey question (survey) that readers answer with one click. Returns the id, audience_count and a preview_url to share with the person. Next step: campaign_preview, then campaign_send_test.'
|
|
715
|
+
description: 'Creates a campaign as a DRAFT. Nothing is sent and no quota is used. Before calling: read brand_get for the voice, pick a template from templates_list, and pick the audience from segments_list. You fill the content blocks; Hollerpost renders the email with the brand header, footer and unsubscribe link. Optionally ask one survey question (survey) that readers answer with one click. Returns the id, audience_count and a preview_url to share with the person. Next step: campaign_preview, then campaign_send_test. ' +
|
|
716
|
+
'Retail promo in one call (template promo): {"info_bar": {"text": "Free shipping over $99", "url": "https://shop.example/shipping"}, "image_url": "https://images.hollerpost.com/...", "image_alt": "...", "image_link": "https://shop.example/sale", "heading": "Up to 30% off", "body_md": "...", "cta_text": "Shop the sale", "cta_url": "https://shop.example/sale", "cta_repeat": "bottom", "layout": "grid-2", "sections": [{"heading": "Maple cue", "price": "$129", "image_url": "https://images.hollerpost.com/...", "image_alt": "Maple cue", "cta_text": "Shop now", "cta_url": "https://shop.example/p/1"}], "fine_print": "Ends Sunday. Not valid with other offers.", "theme": {"button_style": "outline", "button_shape": "pill"}}. ' +
|
|
717
|
+
'The footer link buttons, Follow us icons and disclaimer come from the brand (brand_set_footer), not the blocks. Every send also gets a View in browser link, the mailing address and an unsubscribe link automatically.',
|
|
514
718
|
input: {
|
|
515
719
|
name: z.string().min(1).max(200).describe('Internal campaign name (recipients do not see it).'),
|
|
516
720
|
template_id: z.string().min(1).describe('Template id from templates_list.'),
|
|
@@ -1298,11 +1502,13 @@ export const TOOLS = [
|
|
|
1298
1502
|
}),
|
|
1299
1503
|
];
|
|
1300
1504
|
export const CORE_TOOL_NAMES = [
|
|
1301
|
-
'launchpad_get', 'launchpad_update', 'launchpad_go_live',
|
|
1505
|
+
'launchpad_get', 'launchpad_update', 'launchpad_go_live', 'launchpad_set_offline', 'launchpad_domain_set', 'launchpad_domain_remove',
|
|
1302
1506
|
'page_get', 'page_update', 'page_link_add', 'page_link_update', 'page_link_remove', 'page_links_reorder', 'event_list', 'event_create', 'event_update', 'event_cancel',
|
|
1303
1507
|
'workspace_info',
|
|
1304
1508
|
'brand_get',
|
|
1305
1509
|
'brand_set_voice',
|
|
1510
|
+
'brand_set_footer',
|
|
1511
|
+
'brand_set_theme',
|
|
1306
1512
|
'templates_list',
|
|
1307
1513
|
'email_image_upload',
|
|
1308
1514
|
'email_image_upload_link',
|
package/dist/version.d.ts
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
export declare const VERSION = "0.
|
|
1
|
+
export declare const VERSION = "0.10.0";
|
package/dist/version.js
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
1
|
// Kept in sync with package.json "version" (a test checks it).
|
|
2
|
-
export const VERSION = '0.
|
|
2
|
+
export const VERSION = '0.10.0';
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "hollerpost-mcp",
|
|
3
3
|
"mcpName": "com.hollerpost/mcp",
|
|
4
|
-
"version": "0.
|
|
4
|
+
"version": "0.10.0",
|
|
5
5
|
"description": "MCP server for Hollerpost: let your own AI agent draft, preview, schedule and report on email campaigns in your Hollerpost workspace.",
|
|
6
6
|
"license": "MIT",
|
|
7
7
|
"type": "module",
|