hollerpost-mcp 0.4.0 → 0.5.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 CHANGED
@@ -1,5 +1,16 @@
1
1
  # Changelog
2
2
 
3
+ ## 0.5.0 (2026-11-09)
4
+
5
+ Pictures from the person's own device.
6
+
7
+ - `email_image_upload_link` (scope `draft`): a one-time Hollerpost page
8
+ (30 minutes, up to 10 pictures) where the person uploads pictures an
9
+ agent can't pass as a URL or base64, such as one dropped into a chat.
10
+ - `email_images_list` (scope `read`): the workspace's stored images, newest
11
+ first, to reuse instead of uploading again; with `link_id`, just the
12
+ pictures uploaded through that link.
13
+
3
14
  ## 0.4.0 (2026-11-08)
4
15
 
5
16
  More than one picture per email.
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
  | `brand_set_voice` | draft | Save the brand voice notes (replaces the old text) |
115
115
  | `templates_list` | read | Templates and the content blocks each accepts |
116
116
  | `email_image_upload` | draft | Store an image (from a URL or the file) for use in an email; returns its URL |
117
+ | `email_image_upload_link` | draft | A one-time page where the person uploads pictures from their device |
118
+ | `email_images_list` | read | Stored images, newest first, or the ones from an upload link |
117
119
  | `segments_list` | read | Tags with subscribed counts, for choosing an audience |
118
120
  | `contacts_search` | read | Find contacts by email, status or tag |
119
121
  | `contacts_add` | contacts | Add one contact who opted in (`consent: true` required) |
package/dist/tools.js CHANGED
@@ -316,7 +316,7 @@ export const TOOLS = [
316
316
  name: 'email_image_upload',
317
317
  title: 'Add an email image',
318
318
  scope: 'draft',
319
- description: 'Stores an image on Hollerpost for use in an email and returns its https URL. Pass url (a public https image, for example from the business website) or data_base64 (the file itself, for a picture the person gave you). JPEG, PNG, WebP or GIF, up to 5 MB (GIFs up to 2 MB). Hollerpost shrinks it to at most 1200px wide and saves it as JPEG, or PNG when it has transparency, so the returned type can differ from the upload. Emails link to the image rather than attaching it, so it adds nothing to the message size. Limits: 100 uploads per API key per 24 hours and 500 per workspace per 30 days, so upload each picture once and reuse its url. Use the returned url in image_url, a section image_url, or an image line in body_md: ![What it shows](url). Sends nothing.',
319
+ description: 'Stores an image on Hollerpost for use in an email and returns its https URL. Pass url (a public https image, for example from the business website) or data_base64 (the file itself). For a picture the person has on their device or dropped into the chat, use email_image_upload_link instead. JPEG, PNG, WebP or GIF, up to 5 MB (GIFs up to 2 MB). Hollerpost shrinks it to at most 1200px wide and saves it as JPEG, or PNG when it has transparency, so the returned type can differ from the upload. Emails link to the image rather than attaching it, so it adds nothing to the message size. Limits: 100 uploads per API key per 24 hours and 500 per workspace per 30 days, so upload each picture once and reuse its url. Use the returned url in image_url, a section image_url, or an image line in body_md: ![What it shows](url). Sends nothing.',
320
320
  input: {
321
321
  url: https.max(2000).optional().describe('Public https URL of the image to copy.'),
322
322
  data_base64: z.string().max(7_000_000).optional().describe('The image file, base64 encoded (a data: URL prefix is fine).'),
@@ -331,6 +331,48 @@ export const TOOLS = [
331
331
  return { lead: `Image stored: ${get(data, 'url') ?? 'n/a'}. Use it in image_url, a section, or an image line in body_md.`, data };
332
332
  },
333
333
  }),
334
+ defineTool({
335
+ name: 'email_image_upload_link',
336
+ title: 'Get a link to upload pictures',
337
+ scope: 'draft',
338
+ description: 'Makes a one-time Hollerpost page where the person can upload pictures from their own device (up to 10, JPEG, PNG, WebP or GIF, 5 MB each). Use it when the person has a picture you cannot pass as a public URL or base64, for example one they dropped into this chat. Give them upload_url, wait until they say they are done, then call email_images_list with the link_id to get each picture\'s URL. The link works once and expires after 30 minutes. Sends nothing.',
339
+ input: {},
340
+ annotations: WRITE_SAFE,
341
+ run: async (api) => {
342
+ const data = await api.request('POST', '/media/upload-link', { body: {} });
343
+ return {
344
+ lead: `Ask the person to open ${get(data, 'upload_url') ?? 'the link'} and upload their pictures (it works once, for 30 minutes). When they say they are done, call email_images_list with link_id ${get(data, 'link_id') ?? ''}.`,
345
+ data,
346
+ };
347
+ },
348
+ }),
349
+ defineTool({
350
+ name: 'email_images_list',
351
+ title: 'List email images',
352
+ scope: 'read',
353
+ description: 'Lists images already stored on Hollerpost for this workspace, newest first, with their URLs, so you can reuse one instead of uploading it again. Pass link_id (from email_image_upload_link) to get just the pictures uploaded through that link, and whether the person has used it yet. Free and read only.',
354
+ input: {
355
+ link_id: z.string().uuid().optional().describe('The link_id from email_image_upload_link.'),
356
+ limit: z.number().int().min(1).max(50).optional().describe('How many recent images (default 20).'),
357
+ },
358
+ annotations: READ,
359
+ run: async (api, args) => {
360
+ if (args.link_id) {
361
+ const data = await api.request('GET', `/media/upload-link/${encodeURIComponent(args.link_id)}`);
362
+ const status = get(data, 'status');
363
+ const images = get(data, 'images') ?? [];
364
+ const lead = status === 'used'
365
+ ? `${images.length} picture(s) uploaded. Use each url in image_url, a section, or an image line in body_md.`
366
+ : status === 'open'
367
+ ? 'Nothing uploaded yet. Ask the person to finish uploading on the page, then check again.'
368
+ : `This link is ${status}. Make a new one with email_image_upload_link if they still need to upload.`;
369
+ return { lead, data };
370
+ }
371
+ const query = args.limit ? `?limit=${args.limit}` : '';
372
+ const data = await api.request('GET', `/media${query}`);
373
+ return { lead: countLead('images', data), data };
374
+ },
375
+ }),
334
376
  defineTool({
335
377
  name: 'segments_list',
336
378
  title: 'List segments',
@@ -1097,6 +1139,8 @@ export const CORE_TOOL_NAMES = [
1097
1139
  'brand_set_voice',
1098
1140
  'templates_list',
1099
1141
  'email_image_upload',
1142
+ 'email_image_upload_link',
1143
+ 'email_images_list',
1100
1144
  'segments_list',
1101
1145
  'contacts_search',
1102
1146
  'contacts_add',
package/dist/version.d.ts CHANGED
@@ -1 +1 @@
1
- export declare const VERSION = "0.4.0";
1
+ export declare const VERSION = "0.5.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.4.0';
2
+ export const VERSION = '0.5.0';
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "hollerpost-mcp",
3
- "version": "0.4.0",
3
+ "version": "0.5.0",
4
4
  "description": "MCP server for Hollerpost: let your own AI agent draft, preview, schedule and report on email campaigns in your Hollerpost workspace.",
5
5
  "license": "MIT",
6
6
  "type": "module",