hollerpost-mcp 0.7.1 → 0.8.1
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 +34 -0
- package/README.md +13 -1
- package/dist/format.js +3 -1
- package/dist/server.js +1 -1
- package/dist/tools.js +29 -15
- package/dist/version.d.ts +1 -1
- package/dist/version.js +1 -1
- package/package.json +5 -3
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,39 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 0.8.1 (unreleased, ready to publish)
|
|
4
|
+
|
|
5
|
+
- `mcpName` (`com.hollerpost/mcp`) in package.json and a `server.json` for
|
|
6
|
+
the official MCP registry (GTM-222). No tool changes.
|
|
7
|
+
- Links to hollerpost.com carry source tags (`utm_source=npm`,
|
|
8
|
+
`mcp-registry`, `mcp-client`, `mcp-server`).
|
|
9
|
+
- `npm run docs:tools` builds the docs site's tool table from `src/tools.ts`
|
|
10
|
+
and `docs/tool-docs.json`.
|
|
11
|
+
|
|
12
|
+
- `sms_registration_submit`: the API now answers `submit_in_dashboard`
|
|
13
|
+
(409, with `setup_url`). Hollerpost no longer stores the business
|
|
14
|
+
registration number (EIN or SSN): the person enters it on the dashboard's
|
|
15
|
+
submit step and it goes straight to the carriers, so an agent can fill and
|
|
16
|
+
check the form but the final submit happens in the dashboard. Tool code is
|
|
17
|
+
unchanged; only the description says so.
|
|
18
|
+
|
|
19
|
+
## 0.8.0 (2026-11-13)
|
|
20
|
+
|
|
21
|
+
Breaking: the launch page and Your page are separate pages (L-45).
|
|
22
|
+
|
|
23
|
+
- `page_get` / `page_update` / link and event tools act on Your page only
|
|
24
|
+
(hollerpost.com/@handle/links). `page_update` no longer accepts waitlist
|
|
25
|
+
fields (`mode`, `waitlist_headline`, `waitlist_pitch`, `show_count`,
|
|
26
|
+
`launch_note`, `primary_link_id`): use `launchpad_update`.
|
|
27
|
+
- `launchpad_get`, `launchpad_update` and `launchpad_go_live` act on the launch
|
|
28
|
+
page (/@handle/launch) and report `main_page` (which page /@handle shows).
|
|
29
|
+
`launchpad_update` refuses `mode: standard`.
|
|
30
|
+
- `page_get` reports `main_page`, `publicUrl` and `pageUrl`.
|
|
31
|
+
- `page_update` accepts `sections` (L-46): up to 8 story sections
|
|
32
|
+
`{id?, kind: "story", heading, body, image_url?, image_alt?}`, plain text,
|
|
33
|
+
pictures from images.hollerpost.com only. The list replaces the saved one.
|
|
34
|
+
Needs the L-46 worker and `20261113180000_page_sections.sql`; older API
|
|
35
|
+
builds refuse the field as unknown.
|
|
36
|
+
|
|
3
37
|
## 0.7.1 (2026-11-13)
|
|
4
38
|
|
|
5
39
|
- Edits to a published page through the API now wait as a draft unless the
|
package/README.md
CHANGED
|
@@ -6,6 +6,8 @@ Everything goes through the public API at `https://api.hollerpost.com/api/v1` wi
|
|
|
6
6
|
|
|
7
7
|
- Remote server: `https://mcp.hollerpost.com/mcp` (Streamable HTTP)
|
|
8
8
|
- Local server: `npx -y hollerpost-mcp` (stdio, key in `HOLLERPOST_KEY`)
|
|
9
|
+
- Docs and every tool: [hollerpost.com/docs/mcp](https://hollerpost.com/docs/mcp/?utm_source=npm&utm_medium=referral&utm_campaign=mcp)
|
|
10
|
+
- Hollerpost: [hollerpost.com](https://hollerpost.com/?utm_source=npm&utm_medium=referral&utm_campaign=mcp)
|
|
9
11
|
|
|
10
12
|
Create a key in the Hollerpost Dashboard under **Settings, Developer API**. Keys start with `hp_live_`, or `uc_live_` for Utopian Creations workspaces; both work. Treat a key like a password.
|
|
11
13
|
|
|
@@ -139,7 +141,7 @@ If a tool needs a scope the key lacks, the tool answers `insufficient_scope`, na
|
|
|
139
141
|
| `sms_registration_update` | account | Fill or fix the texting registration form (draft or rejected only). The registration number is entered in the dashboard only |
|
|
140
142
|
| `sms_website_check` | account | Run the carrier checks on the form and the business's website, privacy policy and terms |
|
|
141
143
|
| `sms_numbers` | account | Toll-free numbers available for the first registration |
|
|
142
|
-
| `sms_registration_submit` | account | Submit (or resubmit after a rejection) after the person says yes; needs `confirm: true`. The first time it also buys the chosen number |
|
|
144
|
+
| `sms_registration_submit` | account | Submit (or resubmit after a rejection) after the person says yes; needs `confirm: true`. The first time it also buys the chosen number. Current API builds answer `submit_in_dashboard`: the person submits in the dashboard, where they enter their EIN or SSN (sent straight to the carriers, not kept) |
|
|
143
145
|
| `surveys_list` | read | Surveys with status, questions (and which can go in an email), response counts and share links |
|
|
144
146
|
| `survey_results` | read | Aggregated answers, averages and NPS for one survey |
|
|
145
147
|
| `survey_create` | draft | Create a draft survey (1 to 30 questions) |
|
|
@@ -188,6 +190,16 @@ with an empty box), `checklist` (rows with a ticked box), `microchip`
|
|
|
188
190
|
(cyberpunk chips), `clouds` or `ticket`. Every style uses the theme colors, and
|
|
189
191
|
the main link and signup button stay solid. Social links show as icons.
|
|
190
192
|
|
|
193
|
+
`page_update` also accepts `sections`: story sections shown between the signup
|
|
194
|
+
form and the links (at most 8). Each is `{id?, kind: "story", heading (80),
|
|
195
|
+
body (1,500, plain text, blank line between paragraphs), image_url?, image_alt?}`.
|
|
196
|
+
The list replaces the saved one, so read `page_get` first, keep each section's
|
|
197
|
+
`id` and send every section to keep; `[]` removes them all. Leave `id` out for
|
|
198
|
+
a new section and the API assigns one. No HTML or markdown links. A picture
|
|
199
|
+
must be an `https://images.hollerpost.com/...` URL from `email_image_upload`,
|
|
200
|
+
and `image_alt` is required with it. Section text goes through the same
|
|
201
|
+
publish checks as the rest of the page.
|
|
202
|
+
|
|
191
203
|
`launchpad_update` sends `X-Hollerpost-Save: draft` and cannot set live mode.
|
|
192
204
|
That opt-in draft-save header skips publication checks and preserves any
|
|
193
205
|
previous approved public snapshot; it also refuses a `published` field. A
|
package/dist/format.js
CHANGED
|
@@ -206,7 +206,9 @@ export function describeApiError(err) {
|
|
|
206
206
|
case 'beyond_scheduling_horizon':
|
|
207
207
|
return `${head} That time is further ahead than this plan can schedule${b.limit_days ? ` (${num(b.limit_days)} days)` : ''}.`;
|
|
208
208
|
case 'field_dashboard_only':
|
|
209
|
-
return `${head} The business registration number (EIN, or SSN for a sole proprietor) is entered in the Hollerpost dashboard only, never through an agent.
|
|
209
|
+
return `${head} The business registration number (EIN, or SSN for a sole proprietor) is entered in the Hollerpost dashboard only, never through an agent. The person types it when they submit under Settings, Text messaging; Hollerpost sends it straight to the carriers and doesn't keep it. Nothing was saved.`;
|
|
210
|
+
case 'submit_in_dashboard':
|
|
211
|
+
return `${head} Nothing was submitted or bought. The person submits in the Hollerpost dashboard${typeof b.setup_url === 'string' ? ` (${b.setup_url})` : ''}, Settings, Text messaging: they pick the number there and enter their EIN or SSN, which goes straight to the carriers and isn't kept. Tell them the form is ready (if sms_website_check passed) and where to submit.`;
|
|
210
212
|
case 'confirmation_required':
|
|
211
213
|
return `${head} Nothing was submitted. Show the person what will be sent (sms_setup_status), get a clear yes, then call again with confirm: true.`;
|
|
212
214
|
case 'registration_locked':
|
package/dist/server.js
CHANGED
|
@@ -22,7 +22,7 @@ export const SERVER_INSTRUCTIONS = [
|
|
|
22
22
|
// scopes: the key's scopes (client.keyScopes()), which decide whether the
|
|
23
23
|
// social tools are offered.
|
|
24
24
|
export function createServer(client, options = {}, scopes = null) {
|
|
25
|
-
const server = new McpServer({ name: 'hollerpost-mcp', title: 'Hollerpost', version: VERSION, websiteUrl: 'https://hollerpost.com/docs/mcp
|
|
25
|
+
const server = new McpServer({ name: 'hollerpost-mcp', title: 'Hollerpost', version: VERSION, websiteUrl: 'https://hollerpost.com/docs/mcp/?utm_source=mcp-client&utm_medium=referral&utm_campaign=mcp' }, { instructions: SERVER_INSTRUCTIONS, ...options });
|
|
26
26
|
registerTools(server, client, { scopes });
|
|
27
27
|
registerResources(server, client);
|
|
28
28
|
registerPrompts(server);
|
package/dist/tools.js
CHANGED
|
@@ -216,8 +216,12 @@ const launchpadFields = {
|
|
|
216
216
|
waitlist_pitch: z.string().max(2000).optional(),
|
|
217
217
|
show_count: z.boolean().optional(),
|
|
218
218
|
launch_note: z.string().max(500).optional(),
|
|
219
|
-
primary_link_id: z.string().uuid().nullable().optional().describe('An enabled, safe HTTPS page link in this workspace.
|
|
219
|
+
primary_link_id: z.string().uuid().nullable().optional().describe('An enabled, safe HTTPS page link in this workspace. Live mode needs it unless primary_target is page; null clears it.'),
|
|
220
|
+
primary_target: z.enum(['link', 'page']).optional().describe('Where the live first button goes: link (primary_link_id) or page (the workspace\'s Your page, shown only while Your page is published).'),
|
|
221
|
+
primary_label: z.string().max(80).optional().describe('Button words when primary_target is page.'),
|
|
220
222
|
};
|
|
223
|
+
// L-45: Launchpad tools edit the launch page (its own page at /@handle/launch).
|
|
224
|
+
const LAUNCH_PAGE = { page: 'launch' };
|
|
221
225
|
const pageLinkSchema = z.object({
|
|
222
226
|
label: z.string().min(1).max(80), url: z.string().max(2048),
|
|
223
227
|
thumbnail_url: z.union([z.string().max(2048), z.null()]).optional(), starts_at: z.union([z.string().max(2048), z.null()]).optional(),
|
|
@@ -234,15 +238,25 @@ const pageEventSchema = z.object({
|
|
|
234
238
|
// src/lib/page/validation.js (worker/page-themes.test.mjs checks).
|
|
235
239
|
const PAGE_BODY_FONTS = ['Nunito Sans', 'Nunito', 'sans-serif', 'serif', 'monospace', 'Arial', 'Georgia', 'Lora', 'Outfit', 'Manrope', 'Bricolage Grotesque', 'Space Mono'];
|
|
236
240
|
const PAGE_HEADING_FONTS = ['body', 'Fraunces', 'Instrument Serif', 'Lora', 'Outfit', 'Manrope', 'Bricolage Grotesque', 'Nunito', 'Nunito Sans', 'Unbounded', 'Caveat', 'Pacifico', 'Space Mono'];
|
|
241
|
+
// L-46 story sections. The API checks the same rules (and the image host).
|
|
242
|
+
const pageSectionSchema = z.object({
|
|
243
|
+
id: z.string().regex(/^[a-zA-Z0-9][a-zA-Z0-9-]{0,39}$/).optional().describe('Keep the id of an existing section; leave it out for a new one.'),
|
|
244
|
+
kind: z.literal('story').optional().describe('Always story.'),
|
|
245
|
+
heading: z.string().min(1).max(80).describe('Section heading, plain text.'),
|
|
246
|
+
body: z.string().min(1).max(1500).describe('Plain text. Separate paragraphs with a blank line. No HTML, no markdown links.'),
|
|
247
|
+
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
|
+
image_alt: z.string().max(200).optional().describe('Required with image_url: what the picture shows.'),
|
|
249
|
+
}).strict();
|
|
250
|
+
// Your page only (L-45). Waitlist fields live on the launch page: launchpad_update.
|
|
237
251
|
const pageUpdateSchema = z.object({
|
|
238
|
-
...launchpadFields, mode: z.enum(['standard', 'waitlist', 'live']).optional(),
|
|
239
252
|
title: z.string().max(120).optional(), tagline: z.string().max(240).optional(), avatar_url: z.union([z.string().max(2048), z.null()]).optional(),
|
|
240
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(),
|
|
241
254
|
show_badge: z.boolean().optional(), signup_form_id: z.string().uuid().nullable().optional(),
|
|
242
|
-
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() })).max(15).optional(),
|
|
255
|
+
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(),
|
|
243
256
|
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(),
|
|
257
|
+
sections: z.array(pageSectionSchema).max(8).optional().describe('Story sections shown between the signup form and the links, in order. The FULL list: it replaces the saved one, so read page_get first and send every section to keep (with its id). Send [] to remove them all.'),
|
|
244
258
|
show_events: z.boolean().optional(), published: z.boolean().optional(),
|
|
245
|
-
});
|
|
259
|
+
}).strict();
|
|
246
260
|
const PAGE_DESTRUCTIVE = { ...WRITE_IDEMPOTENT, destructiveHint: true };
|
|
247
261
|
function launchpadPublicationLead(data) {
|
|
248
262
|
const status = get(data, 'moderation_status');
|
|
@@ -257,41 +271,41 @@ function launchpadPublicationLead(data) {
|
|
|
257
271
|
export const TOOLS = [
|
|
258
272
|
defineTool({
|
|
259
273
|
name: 'launchpad_get', title: 'Get Launchpad', scope: 'read',
|
|
260
|
-
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 and page
|
|
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.',
|
|
261
275
|
input: {}, annotations: READ, untrusted: true,
|
|
262
276
|
run: async (api) => {
|
|
263
277
|
const data = await api.request('GET', '/launchpad');
|
|
264
|
-
return { lead: `Launchpad: confirmed_signups=${get(data, 'confirmed_signups') ?? 'unavailable'}, emailable_subscribers=${get(data, 'emailable_subscribers') ?? 'unavailable'}, awaiting_confirmation=${get(data, 'awaiting_confirmation') ?? 'unavailable'}.`, data };
|
|
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'}.`, data };
|
|
265
279
|
},
|
|
266
280
|
}),
|
|
267
281
|
defineTool({
|
|
268
282
|
name: 'launchpad_update', title: 'Update Launchpad draft', scope: 'draft',
|
|
269
|
-
description: 'Save
|
|
270
|
-
input: { ...launchpadFields, mode: z.enum(['waitlist'
|
|
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() },
|
|
271
285
|
annotations: WRITE_IDEMPOTENT, untrusted: true,
|
|
272
286
|
run: async (api, args) => {
|
|
273
287
|
const body = Object.fromEntries(Object.entries(args).filter(([, v]) => v !== undefined));
|
|
274
288
|
if (!Object.keys(body).length)
|
|
275
289
|
throw new InputError('Nothing to update: pass at least one Launchpad field.');
|
|
276
|
-
const data = await api.request('PATCH', '/page', { body, headers: { 'X-Hollerpost-Save': 'draft' } });
|
|
290
|
+
const data = await api.request('PATCH', '/page', { query: LAUNCH_PAGE, body, headers: { 'X-Hollerpost-Save': 'draft' } });
|
|
277
291
|
return { lead: 'Launchpad draft saved. These changes have not been published.', data };
|
|
278
292
|
},
|
|
279
293
|
}),
|
|
280
294
|
defineTool({
|
|
281
295
|
name: 'launchpad_go_live', title: 'Launchpad go live', scope: 'draft',
|
|
282
|
-
description: 'Switch
|
|
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.',
|
|
283
297
|
input: { confirm: z.literal(true).describe('true only after the person saw the launch note and primary link and approved going live.') },
|
|
284
298
|
annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: false, openWorldHint: true }, untrusted: true,
|
|
285
299
|
run: async (api, { confirm }) => {
|
|
286
300
|
if (confirm !== true)
|
|
287
301
|
throw new InputError('Going live requires confirm: true after the person approves the launch note and primary link.');
|
|
288
|
-
const data = await api.request('PATCH', '/page', { body: { mode: 'live', published: true }, headers: { 'X-Hollerpost-Confirm': 'publish' } });
|
|
302
|
+
const data = await api.request('PATCH', '/page', { query: LAUNCH_PAGE, body: { mode: 'live', published: true }, headers: { 'X-Hollerpost-Confirm': 'publish' } });
|
|
289
303
|
return { lead: launchpadPublicationLead(data), data };
|
|
290
304
|
},
|
|
291
305
|
}),
|
|
292
|
-
defineTool({ name: 'page_get', title: 'Get Your page', scope: 'read', description: 'Read Your page, links, events, handle and plan settings. An unsaved draft from the brand kit is returned if no page exists.', input: {}, annotations: READ, untrusted: true,
|
|
293
|
-
run: async (api) => ({ lead:
|
|
294
|
-
defineTool({ name: 'page_update', title: 'Update Your page', scope: 'draft', description: 'Update Your page fields
|
|
306
|
+
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
|
+
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
|
+
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,
|
|
295
309
|
run: async (api, { updates, confirm_publish }) => ({ lead: 'Your page updated.', data: await api.request('PATCH', '/page', { body: updates, ...(confirm_publish ? { headers: { 'X-Hollerpost-Confirm': 'publish' } } : {}) }) }) }),
|
|
296
310
|
defineTool({ name: 'page_link_add', title: 'Add page link', scope: 'draft', description: 'Add a HTTPS link to Your page (maximum 30). Known URL shorteners are refused. On a published page the change is saved as a draft and the public page keeps its approved version until the person approves publishing; then pass confirm_publish: true.', input: { link: pageLinkSchema, confirm_publish: z.literal(true).optional().describe('true only after the person explicitly approved publishing; without it, changes to a published page wait as a draft.') }, annotations: WRITE_SAFE, untrusted: true,
|
|
297
311
|
run: async (api, { link, confirm_publish }) => ({ lead: 'Page link added.', data: await api.request('POST', '/page/links', { body: link, ...(confirm_publish ? { headers: { 'X-Hollerpost-Confirm': 'publish' } } : {}) }) }) }),
|
|
@@ -914,7 +928,7 @@ export const TOOLS = [
|
|
|
914
928
|
name: 'sms_registration_submit',
|
|
915
929
|
title: 'Submit the texting registration',
|
|
916
930
|
scope: 'account',
|
|
917
|
-
description: 'Sends the registration to the carriers for review. The first time it also buys the chosen toll-free number (phone_number from sms_numbers, included in the person\'s add-on). After a rejection it resubmits the same request with the fixes. Only after the person reviewed the form (sms_setup_status) and said yes: needs confirm: true. Every check runs again first; if one fails, nothing is sent or bought. Review takes 1 to 2 weeks, sometimes a month; never promise a date. The person gets an email when the status changes.',
|
|
931
|
+
description: 'Sends the registration to the carriers for review. The first time it also buys the chosen toll-free number (phone_number from sms_numbers, included in the person\'s add-on). After a rejection it resubmits the same request with the fixes. Only after the person reviewed the form (sms_setup_status) and said yes: needs confirm: true. Every check runs again first; if one fails, nothing is sent or bought. Current API builds answer submit_in_dashboard: the submit needs the person\'s EIN or SSN, which Hollerpost sends straight to the carriers and does not keep, so the person submits in the dashboard (setup_url, Settings, Text messaging); pass that on. Review takes 1 to 2 weeks, sometimes a month; never promise a date. The person gets an email when the status changes.',
|
|
918
932
|
input: {
|
|
919
933
|
confirm: z.literal(true).describe('true: the person approved submitting.'),
|
|
920
934
|
phone_number: z.string().regex(/^\+18(00|33|44|55|66|77|88)\d{7}$/).optional().describe('First submission only: the toll-free number the person picked, E.164 (+18335550100).'),
|
package/dist/version.d.ts
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
export declare const VERSION = "0.
|
|
1
|
+
export declare const VERSION = "0.8.1";
|
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.8.1';
|
package/package.json
CHANGED
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "hollerpost-mcp",
|
|
3
|
-
"
|
|
3
|
+
"mcpName": "com.hollerpost/mcp",
|
|
4
|
+
"version": "0.8.1",
|
|
4
5
|
"description": "MCP server for Hollerpost: let your own AI agent draft, preview, schedule and report on email campaigns in your Hollerpost workspace.",
|
|
5
6
|
"license": "MIT",
|
|
6
7
|
"type": "module",
|
|
@@ -23,7 +24,7 @@
|
|
|
23
24
|
"email",
|
|
24
25
|
"newsletter"
|
|
25
26
|
],
|
|
26
|
-
"homepage": "https://hollerpost.com/docs/mcp
|
|
27
|
+
"homepage": "https://hollerpost.com/docs/mcp/?utm_source=npm&utm_medium=referral&utm_campaign=mcp",
|
|
27
28
|
"scripts": {
|
|
28
29
|
"build": "tsc -p tsconfig.build.json && chmod +x dist/stdio.js",
|
|
29
30
|
"typecheck": "tsc --noEmit -p tsconfig.json",
|
|
@@ -32,7 +33,8 @@
|
|
|
32
33
|
"start:stdio": "node dist/stdio.js",
|
|
33
34
|
"inspect:stdio": "npm run build && npx @modelcontextprotocol/inspector@2.9.0 --cli -e HOLLERPOST_KEY=hp_live_dummy --method tools/list --strict node dist/stdio.js",
|
|
34
35
|
"e2e": "tsx test/e2e.ts",
|
|
35
|
-
"prepublishOnly": "npm run typecheck && npm test && npm run build"
|
|
36
|
+
"prepublishOnly": "npm run typecheck && npm test && npm run build",
|
|
37
|
+
"docs:tools": "tsx scripts/tool-docs.ts"
|
|
36
38
|
},
|
|
37
39
|
"dependencies": {
|
|
38
40
|
"@modelcontextprotocol/sdk": "1.32.0",
|