hollerpost-mcp 0.9.0 → 0.11.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 +19 -1
- package/dist/tools.js +57 -6
- 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,24 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
-
## 0.
|
|
3
|
+
## 0.11.0 (2026-11-17)
|
|
4
|
+
|
|
5
|
+
- `brand_set_theme` takes `theme.logo_dark`: an https image URL (store it
|
|
6
|
+
with `email_image_upload` first) for the logo shown when the reader's mail
|
|
7
|
+
app is in dark mode. `""` removes it. `brand_get` returns it as
|
|
8
|
+
`theme.logo_dark` (null when there is none).
|
|
9
|
+
|
|
10
|
+
## 0.10.0 (2026-11-16)
|
|
11
|
+
|
|
12
|
+
- New `launchpad_domain_set` (`hostname`, `confirm: true`) and
|
|
13
|
+
`launchpad_domain_remove` (`confirm: true`): serve the launch page at the
|
|
14
|
+
business's own subdomain (like join.yourbusiness.com) with one CNAME to
|
|
15
|
+
pages.hollerpost.com. Paid plans only; bare domains are refused.
|
|
16
|
+
`launchpad_get` reports `custom_domain` (address, status, the record to add).
|
|
17
|
+
- Page motion: `page_update` `theme.motion` and `launchpad_update`
|
|
18
|
+
`design.style.motion` take `lively` (the default when unset), `subtle` or
|
|
19
|
+
`off`. Visitors who ask their device for reduced motion always get none.
|
|
20
|
+
|
|
21
|
+
## 0.9.0 (2026-11-16)
|
|
4
22
|
|
|
5
23
|
Retail promo emails (511-style layout) in one call, and the Launchpad advanced editor, offline switch and page design.
|
|
6
24
|
|
package/dist/tools.js
CHANGED
|
@@ -300,6 +300,8 @@ const designBlockSchema = z.discriminatedUnion('type', [
|
|
|
300
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
301
|
]);
|
|
302
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.');
|
|
303
305
|
const launchDesignSchema = z.object({
|
|
304
306
|
version: z.literal(1).optional(),
|
|
305
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,13 +310,14 @@ const launchDesignSchema = z.object({
|
|
|
308
310
|
accentColor: hex.optional().describe('Buttons.'), buttonTextColor: hex.optional(),
|
|
309
311
|
fontFamily: z.enum(PAGE_BODY_FONTS).optional(), headingFont: z.enum(PAGE_HEADING_FONTS).optional().describe('body means the same as fontFamily.'),
|
|
310
312
|
buttonShape: z.enum(['square', 'rounded', 'pill']).optional(), buttonStyle: z.enum(['solid', 'outline']).optional(),
|
|
313
|
+
motion: pageMotion,
|
|
311
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).'),
|
|
312
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.'),
|
|
313
316
|
}).strict();
|
|
314
317
|
// Your page only (L-45). Waitlist fields live on the launch page: launchpad_update.
|
|
315
318
|
const pageUpdateSchema = z.object({
|
|
316
319
|
title: z.string().max(120).optional(), tagline: z.string().max(240).optional(), avatar_url: z.union([z.string().max(2048), z.null()]).optional(),
|
|
317
|
-
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(),
|
|
318
321
|
show_badge: z.boolean().optional(), signup_form_id: z.string().uuid().nullable().optional(),
|
|
319
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(),
|
|
320
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(),
|
|
@@ -322,6 +325,26 @@ const pageUpdateSchema = z.object({
|
|
|
322
325
|
show_events: z.boolean().optional(), published: z.boolean().optional(),
|
|
323
326
|
}).strict();
|
|
324
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
|
+
};
|
|
325
348
|
function launchpadPublicationLead(data) {
|
|
326
349
|
const status = get(data, 'moderation_status');
|
|
327
350
|
if (get(data, 'pending_review') === true || status === 'pending_review' || status === 'review_pending' || status === 'rejected' || status === 'unpublished') {
|
|
@@ -335,11 +358,11 @@ function launchpadPublicationLead(data) {
|
|
|
335
358
|
export const TOOLS = [
|
|
336
359
|
defineTool({
|
|
337
360
|
name: 'launchpad_get', title: 'Get Launchpad', scope: 'read',
|
|
338
|
-
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.',
|
|
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.',
|
|
339
362
|
input: {}, annotations: READ, untrusted: true,
|
|
340
363
|
run: async (api) => {
|
|
341
364
|
const data = await api.request('GET', '/launchpad');
|
|
342
|
-
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}
|
|
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 };
|
|
343
366
|
},
|
|
344
367
|
}),
|
|
345
368
|
defineTool({
|
|
@@ -367,6 +390,33 @@ export const TOOLS = [
|
|
|
367
390
|
return { lead: launchpadPublicationLead(data), data };
|
|
368
391
|
},
|
|
369
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
|
+
}),
|
|
370
420
|
defineTool({
|
|
371
421
|
name: 'launchpad_set_offline', title: 'Take Launchpad page offline or back online', scope: 'draft',
|
|
372
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.',
|
|
@@ -425,7 +475,7 @@ export const TOOLS = [
|
|
|
425
475
|
name: 'brand_get',
|
|
426
476
|
title: 'Get brand',
|
|
427
477
|
scope: 'read',
|
|
428
|
-
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.',
|
|
478
|
+
description: 'Returns the brand settings: workspace and from name, reply-to, logo, colors, the theme (background, surface, text, button_style, button_shape, logo_dark: the logo shown when the reader\u2019s mail app is in dark mode, null when there is none), 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.',
|
|
429
479
|
input: {},
|
|
430
480
|
annotations: READ,
|
|
431
481
|
run: async (api) => {
|
|
@@ -487,7 +537,7 @@ export const TOOLS = [
|
|
|
487
537
|
name: 'brand_set_theme',
|
|
488
538
|
title: 'Save email look',
|
|
489
539
|
scope: 'draft',
|
|
490
|
-
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. ' +
|
|
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), the dark-mode logo (logo_dark) 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. logo_dark is a light-colored version of the logo for readers in dark mode (Apple Mail, iOS Mail, Outlook.com); store it first with email_image_upload (a PNG with a transparent background works best) and pass the returned url; "" removes it. Uses no quota and sends nothing. Only save what the person approved. ' +
|
|
491
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"}}',
|
|
492
542
|
input: {
|
|
493
543
|
theme: z
|
|
@@ -497,6 +547,7 @@ export const TOOLS = [
|
|
|
497
547
|
text: hexColor.or(z.literal('')).optional().describe('Body text color.'),
|
|
498
548
|
button_style: z.enum(['solid', 'outline']).nullable().optional().describe('solid or outline; null goes back to solid.'),
|
|
499
549
|
button_shape: z.enum(['pill', 'rounded']).nullable().optional().describe('pill or rounded; null goes back to the brand radius.'),
|
|
550
|
+
logo_dark: https.max(2000).or(z.literal('')).optional().describe('Logo for dark mode: an https image URL from email_image_upload, light-colored so it reads on a dark background. "" removes it.'),
|
|
500
551
|
})
|
|
501
552
|
.strict()
|
|
502
553
|
.optional(),
|
|
@@ -1452,7 +1503,7 @@ export const TOOLS = [
|
|
|
1452
1503
|
}),
|
|
1453
1504
|
];
|
|
1454
1505
|
export const CORE_TOOL_NAMES = [
|
|
1455
|
-
'launchpad_get', 'launchpad_update', 'launchpad_go_live', 'launchpad_set_offline',
|
|
1506
|
+
'launchpad_get', 'launchpad_update', 'launchpad_go_live', 'launchpad_set_offline', 'launchpad_domain_set', 'launchpad_domain_remove',
|
|
1456
1507
|
'page_get', 'page_update', 'page_link_add', 'page_link_update', 'page_link_remove', 'page_links_reorder', 'event_list', 'event_create', 'event_update', 'event_cancel',
|
|
1457
1508
|
'workspace_info',
|
|
1458
1509
|
'brand_get',
|
package/dist/version.d.ts
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
export declare const VERSION = "0.
|
|
1
|
+
export declare const VERSION = "0.11.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.11.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.11.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",
|