hollerpost-mcp 0.8.0 → 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 +16 -0
- package/README.md +3 -1
- package/dist/format.js +3 -1
- package/dist/server.js +1 -1
- package/dist/tools.js +2 -2
- 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,21 @@
|
|
|
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
|
+
|
|
3
19
|
## 0.8.0 (2026-11-13)
|
|
4
20
|
|
|
5
21
|
Breaking: the launch page and Your page are separate pages (L-45).
|
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) |
|
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
|
@@ -252,7 +252,7 @@ const pageUpdateSchema = z.object({
|
|
|
252
252
|
title: z.string().max(120).optional(), tagline: z.string().max(240).optional(), avatar_url: z.union([z.string().max(2048), z.null()]).optional(),
|
|
253
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(),
|
|
254
254
|
show_badge: z.boolean().optional(), signup_form_id: z.string().uuid().nullable().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() })).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(),
|
|
256
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
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.'),
|
|
258
258
|
show_events: z.boolean().optional(), published: z.boolean().optional(),
|
|
@@ -928,7 +928,7 @@ export const TOOLS = [
|
|
|
928
928
|
name: 'sms_registration_submit',
|
|
929
929
|
title: 'Submit the texting registration',
|
|
930
930
|
scope: 'account',
|
|
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. 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.',
|
|
932
932
|
input: {
|
|
933
933
|
confirm: z.literal(true).describe('true: the person approved submitting.'),
|
|
934
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.8.
|
|
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.8.
|
|
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",
|