All servers / Social / Hollerpost MCP server
Hollerpost MCP server
MCP server for Hollerpost: let your own AI agent draft, preview, schedule and report on email campaigns in your Hollerpost workspace.
Tested by ConnectATDScore 84 out of 100. Tested 2026-11-18 on package version 0.11.0. Package: hollerpost-mcp
Score breakdown
| Runs | 18 / 20 | |
|---|---|---|
| Tool descriptions | 18 / 20 | |
| Package safety | 16 / 20 | |
| Maintenance | 20 / 20 | |
| Adoption | 12 / 20 |
What we saw
- Starts and answers the MCP handshake: yes (1.8 seconds including download)
- Tools offered: 54
- Last published: 2026-11-17
- Weekly downloads (npm): 1,525
- License: MIT · Direct dependencies: 2
Want this server set up for your team?
ConnectATD builds AI automation and wires up MCP servers like this one. Tell us what you are trying to do.
Talk to ConnectATDTools and how they are described
Agents choose tools from these descriptions. Under each name you can see how many of its parameters are explained.
launchpad_getno parametersRead 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. Requires API key scope: read.
launchpad_update4 of 9 parameters describedSave 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. Requires API key scope: draft.
launchpad_go_live1 of 1 parameter describedSwitch 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. Requires API key scope: draft.
launchpad_domain_set2 of 2 parameters describedShow 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. Requires API key scope: draft.
launchpad_domain_remove1 of 1 parameter describedStop showing the launch page at its own address. The hollerpost.com address keeps working. Ask for confirmation first; requires confirm: true. Requires API key scope: draft.
launchpad_set_offline2 of 2 parameters describedTake 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. Requires API key scope: draft.
page_getno parametersRead 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. Requires API key scope: read.
page_update1 of 2 parameters describedUpdate 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. Requires API key scope: draft.
page_link_add1 of 2 parameters describedAdd 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. Requires API key scope: draft.
page_link_update1 of 3 parameters describedUpdate a workspace page link by ID. Omitted fields stay unchanged. 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. Requires API key scope: draft.
page_link_remove1 of 3 parameters describedPermanently remove a page link. Ask for confirmation before calling; requires confirm: true. 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. Requires API key scope: draft.
page_links_reorder1 of 2 parameters describedReplace link ordering. Include every workspace link ID exactly once. 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. Requires API key scope: draft.
event_listno parametersList workspace calendar events, including upcoming and the past 90 days. These are calendar events, not email delivery events. Requires API key scope: read.
event_create1 of 2 parameters describedCreate a calendar event. Defaults to draft. Status published shows it on Your page right away: ask the person first and pass confirm_publish: true. Use an IANA timezone and ISO dates with offsets. Requires API key scope: draft.
event_update1 of 3 parameters describedUpdate a calendar event by ID. Fields omitted are unchanged. Changes to a published event wait as a draft until the person approves publishing (confirm_publish: true). Setting status published needs the person's approval and confirm_publish: true. Requires API key scope: draft.
event_cancel0 of 2 parameters describedCancel an event and remove it from the public page, retaining its record. Ask for confirmation before calling; requires confirm: true. Requires API key scope: draft.
workspace_infono parametersStart here. Returns who this key belongs to: workspace name, plan, the scopes this key has, and the brand (voice, colors, from name, sending domain). Free and read only; uses no quota. Call it at the start of a conversation so you know which tools this key may use and how to write on-brand. Requires API key scope: read.
brand_getno parametersReturns 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’s 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. Requires API key scope: read.
brand_set_voice1 of 1 parameter describedSaves the brand voice notes (how this business writes: tone, words to use or avoid). Replaces the previous voice text entirely, so read brand_get first and include anything worth keeping. Uses no quota and sends nothing. Reversible by saving the old text again. Only save what the person dictated or approved. Requires API key scope: draft.
brand_set_footer4 of 4 parameters describedSaves 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’s, 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. Example: {"links": [{"label": "Shop men’s", "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."} Requires API key scope: draft.
brand_set_theme1 of 2 parameters describedSaves 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. 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"}} Requires API key scope: draft.
templates_listno parametersLists the email templates and, for each, the blocks_schema (JSON Schema for heading, body_md, cta_text, cta_url, image_url, image_alt and sections). Free and read only. Pick a template here before campaign_draft and fill only the blocks its schema accepts. Requires API key scope: read.
email_image_upload3 of 3 parameters describedStores 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: . Sends nothing. Requires API key scope: draft.
email_image_upload_linkno parametersMakes 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. Requires API key scope: draft.
email_images_list2 of 2 parameters describedLists 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. Requires API key scope: read.
segments_listno parametersLists contact tags and built-in waitlist audiences (signup_form_id) with subscribed counts. Free and read only. Use it to choose a campaign audience by tag or signup_form_id and to tell the person roughly how many people a send reaches. Requires API key scope: read.
contacts_search4 of 4 parameters describedFinds contacts by exact email, status or tag, newest first. Free and read only. Status "subscribed" means active; "unsubscribed" covers suppressed addresses. Returns at most `limit` rows (default 50, max 200). Requires API key scope: read.
contacts_add5 of 5 parameters describedAdds one contact, or merges tags into an existing one. Uses no send quota. ONLY add a person who agreed to receive marketing email from this business (for example they signed up, or the person you are helping confirms they opted in). If you are not sure, ask first. Addresses that unsubscribed, bounced or complained cannot be re-added. Not reversible through these tools (there is no delete tool), so check the email is right. Requires API key scope: contacts.
campaign_draft7 of 7 parameters describedCreates 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. 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"}}. 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. Requires API key scope: draft.
campaign_update8 of 8 parameters describedEdits a campaign while it is still a draft: any of name, template, subject, preheader, blocks, audience or the survey question. Fields you leave out stay as they are; blocks you pass replace the whole blocks object; survey null removes the question. Uses no quota and sends nothing. Refused with campaign_locked once the campaign is scheduled or sent. Run campaign_preview again after editing. Requires API key scope: draft.
campaign_preview1 of 1 parameter describedRenders a draft and returns the text version, the live audience_count, quota_after_send and warnings (empty subject, missing button, over quota, first campaign pending review). Free, read only, sends nothing. Always call this before campaign_schedule and tell the person the audience count, the quota it will use and every warning. Requires API key scope: draft.
campaign_send_test2 of 2 parameters describedSends a test copy of a draft to up to 3 addresses. The addresses must belong to users of this workspace; other addresses are refused. Uses quota only for the test emails actually sent, does not touch the audience, and does not change the draft. Offer this after campaign_preview so the person can check it in their own inbox. Requires API key scope: draft.
campaign_schedule4 of 4 parameters describedSchedules a drafted campaign to send to its audience. This is not reversible once sending starts, and it uses one email of quota per recipient. Call campaign_preview first, tell the person the audience count and the quota it uses, and only call this after they say yes. Pass the audience count you showed them as expected_audience_count; if the list changed meaningfully the call is refused. A workspace's first campaign is held for a one-time human review instead of sending (review_pending); say so plainly and do not retry. Before send_at, campaign_cancel can still stop it. Requires API key scope: send.
campaign_cancel1 of 1 parameter describedCancels a scheduled campaign before it starts sending. Only works while the status is scheduled; once sending has started it cannot be stopped. Uses no quota. Confirm with the person which campaign they mean (campaigns_list with status scheduled) before calling. Requires API key scope: send.
campaigns_list2 of 2 parameters describedLists campaigns, newest first, optionally filtered by status (draft, scheduled, sending, sent, held_for_review, canceled). Free and read only. Requires API key scope: read.
campaign_stats1 of 1 parameter describedReturns delivery and engagement numbers for a campaign: sent, delivered, bounced, complained, opened, clicked, unsubscribed and top links. Free and read only. Requires API key scope: read.
email_send7 of 7 parameters describedSends ONE transactional email (a receipt, a reply, a booking confirmation) to one address right away. Not reversible, and it uses one email of quota. Never use it for marketing or to mail a list: campaigns are for that. Show the person the recipient, subject and body and get a yes before calling, then pass confirm: true. idempotency_key is required: reuse the same key if you retry so the email is not sent twice. Pass html, text, or both. Requires API key scope: send.
events_recent2 of 2 parameters describedLists recent delivery events of one type across campaigns and transactional mail: email.bounced (default), email.complained or email.delivered. Free and read only. Useful for list hygiene and deliverability questions. Requires API key scope: read.
account_getno parametersReturns the plan, billing period end, email and SMS quota used and limit, and the send packs available. Free and read only. Check it before a large send. Plan changes and purchases are never done through tools: use billing_portal_link to give the person a link. Requires API key scope: read.
account_update4 of 4 parameters describedUpdates the workspace name, from name, reply-to address or the physical footer address (required by law in marketing email). Uses no quota. Reversible by setting the old value again. Billing can never be changed here. Confirm the new values with the person first. Requires API key scope: account.
domain_add1 of 1 parameter describedAdds a sending domain (one per workspace) and returns the exact DNS records to create, plus registrar_hint (cloudflare, godaddy, namecheap, route53, vercel or unknown). Uses no quota. Safe to call again: an existing domain returns its current records. If you have a DNS provider tool for that registrar connected, offer to add the records yourself; otherwise show them as a table and point the person to their DNS settings or the Hollerpost dashboard. Then call domain_verify. Requires API key scope: account.
domain_listno parametersLists the sending domain and its status (pending, verified or failed) with each DNS record and whether it was found. Free and read only. Check this before drafting: a workspace that must send from its own domain cannot schedule until it is verified. Requires API key scope: read.
domain_verify1 of 1 parameter describedRe-checks the DNS records for a sending domain now and returns, per record, whether it was found plus expected vs actual values. Uses no quota, changes nothing, safe to repeat. DNS changes can take minutes to a few hours to show up; if records are missing right after adding them, wait a bit and try again. Explain any wrong record in plain words. Requires API key scope: account.
domain_remove2 of 2 parameters describedRemoves the sending domain from this workspace. Destructive: campaigns cannot be scheduled from it afterwards, and adding it back gives new DNS records to set up again. Refused with domain_in_use while a campaign is scheduled on it. Uses no quota. Only call when the person explicitly asked to remove this exact domain. Requires API key scope: account.
sms_setup_statusno parametersReturns where this workspace stands on texting: the status of its own toll-free number registration (none, draft, submitted, in_review, rejected or verified), the number, when it was submitted, the saved form (registration number masked), the checklist the business must meet, the latest website check results, and, after a rejection, a plain explanation with fix steps. Free and read only. Carriers only deliver marketing texts from a toll-free number verified under the business itself, which takes 1 to 2 weeks and sometimes up to a month: never promise a date. Use it to walk the person through the checklist item by item (privacy policy sentence, optional standalone opt-in, sample messages starting with the brand and ending "Reply STOP to opt out"). With the account scope you can fill and fix the form (sms_registration_update), run the checks (sms_website_check) and submit after a yes (sms_registration_submit); the registration number is always entered in the dashboard at setup_url. Text campaigns cannot be scheduled until status is verified. Requires API key scope: read.
sms_registration_update1 of 1 parameter describedSaves fields of the toll-free texting registration as a draft (only while it is a draft or was rejected; never while the carriers review it). Send only the fields you are changing. Every fact must come from the person: ask for the legal name, entity type, address, contact and how people opt in; never guess or invent them, because carriers reject registrations that don't match official records. You may draft the use case summary, opt-in description and sample messages for the person to approve: each sample starts with the business name and ends "Reply STOP to opt out". The registration number (EIN, or SSN for a sole proprietor) cannot be set here: the person enters it in the dashboard. Returns the saved form (number masked) and the checklist. Nothing is sent to the carriers. Requires API key scope: account.
sms_website_checkno parametersRuns every check the carriers care about on the saved registration, without submitting: missing or invalid form fields, and a live look at the person's website, privacy policy and terms (public, has the business name and address, and the privacy policy has the required sentence about mobile information). A few runs per 10 minutes. Use the results to help the person fix their form or their own site, then check again. Requires API key scope: account.
sms_numbers0 of 1 parameter describedLists toll-free numbers available for this workspace's first texting registration. Optional prefix (800, 833, 844, 855, 866, 877, 888). Read only: nothing is bought until sms_registration_submit. Requires API key scope: account.
sms_registration_submit2 of 2 parameters describedSends 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. Requires API key scope: account.
surveys_listno parametersLists the workspace’s surveys with status (draft, open or closed), response count, questions (with ids and whether each can be answered from an email) and, when open, the public link to share. Free and read only. Use survey_results for the answers. Requires API key scope: read.
survey_results1 of 1 parameter describedReturns aggregated results for one survey: response and completion counts, and per question the answer counts, average rating, NPS (promoters minus detractors) and the latest written answers. No contact identities. Free and read only. Summarize trends in plain words; do not over-read small samples. Requires API key scope: read.
survey_create4 of 5 parameters describedCreates a survey as a DRAFT: its page is not public and no email can ask its questions until it is opened with survey_update. Give it a name and 1 to 30 questions. Returns the survey with each question id; one_click questions (rating, nps, single) can go in an email with campaign_draft. Sends nothing and uses no quota. Requires API key scope: draft.
survey_update2 of 7 parameters describedEdits a survey, or opens or closes it with status. Opening makes the survey page public and lets campaigns that ask its questions be test-sent and scheduled; closing stops new answers. Questions you pass replace the whole list; keep each existing question id so earlier answers stay matched. Fields you leave out stay as they are. Sends nothing. Requires API key scope: draft.
billing_portal_linkno parametersReturns a short-lived link to the Stripe billing portal for the person to open in their browser, where they can change plan, update a card or buy send packs. This is the only billing tool: you never change plans or buy anything yourself. Free; changes nothing. The link expires, so get a fresh one when needed and do not store it. Requires API key scope: account.
Tested in a sandbox with an empty environment: no API keys, a throwaway folder, nothing from a real account. A passing test shows the server runs and responds. It is not a security audit.