Skip to content
hollerpost Start free
PricingGuidesHow-toIntegrationsSwitch from Mailchimpvs Mailchimp
English
  • English
  • Español
Log in Start free

Hollerpost MCP server

Connect the AI assistant you already use to your Hollerpost workspace. The remote URL is https://mcp.hollerpost.com/mcp.

What it is

MCP (Model Context Protocol) is how AI assistants like Claude, ChatGPT and Cursor use outside tools. Our MCP server gives your assistant a set of Hollerpost tools: read your brand, add contacts who said yes, draft a campaign in one of your templates, preview it, send you a test, and report on how it did. Your assistant does the writing and the thinking. Hollerpost renders the email with your header, footer and unsubscribe link, and sends it from your own domain. Everything goes through the same Hollerpost API and the same API key, so it has the same limits and the same consent rules. It’s included on every plan, Free included.

Set up your whole account from chat

The server comes with a prompt called setup_workspace. Pick it from your assistant’s list of prompts (or just ask it to set up your Hollerpost account) and it walks through the whole thing: checks your account, adds your sending domain, hands you the DNS records, checks them, saves notes on how you like to sound, adds the first contacts you paste in (once you confirm they agreed), and drafts a welcome email. It stops before anything sends.

If your assistant also has a tool for your DNS provider (Cloudflare has one, for example), it can offer to add the records for you. Otherwise it shows them as a table you copy over. Here’s roughly how the domain part goes:

  1. You

    Set up my Hollerpost account. I want to send from mail.sunnyside.example.

  2. Your assistant

    You’re on the Free plan for Sunny Side Salon. I added mail.sunnyside.example. Your DNS is at Cloudflare, so add the records in this table there. I’ll check them when you say they’re in.

  3. You

    Done.

  4. Your assistant

    Most of them are found. One DKIM record isn’t: its name should end in ._domainkey.mail.sunnyside.example, and the one I see ends in .sunnyside.example twice. Cloudflare adds your domain for you, so paste only the first part.

  5. You

    Fixed it.

  6. Your assistant

    All records found. mail.sunnyside.example is verified, so you can send from it. Next: want to tell me how you like your emails to sound?

Connect

First, make an API key in your dashboard under Settings, Developer API. Keys start with hp_live_, or uc_live_ for Utopian Creations workspaces. Either works here, and the key is shown once. Make a separate key for your AI so you can revoke it on its own.

When you create the key, the dashboard also shows a connector URL with your key already in it, and a ready-made Claude Code command. Copy the one you need before you click Done. Then pick your assistant below.

There are three ways to connect:

  • Connector URL (Claude.ai, Claude Desktop connectors, ChatGPT): https://mcp.hollerpost.com/mcp?key=hp_live_your_key_here. Your key rides in the URL, and you leave authentication empty. Nothing to install.
  • Header (Claude Code, Cursor): https://mcp.hollerpost.com/mcp, with the header Authorization: Bearer hp_live_your_key_here.
  • Local: npx -y hollerpost-mcp, with your key in the HOLLERPOST_KEY environment variable. Runs on your computer and needs Node.js. The package is hollerpost-mcp on npm.

Claude (claude.ai and Claude Desktop connectors)

  1. Go to Customize, then Connectors. Click + Add, then Add custom connector.
  2. Name it Hollerpost and paste your connector URL, the one with ?key= on the end: https://mcp.hollerpost.com/mcp?key=hp_live_your_key_here.
  3. Leave the authentication and advanced settings empty: no OAuth client ID, no request headers. Click Add.

We recommend the URL over a request header here: it’s the setup we’ve tested end to end with Claude’s connectors, and it has the fewest settings to get wrong.

The URL contains your key, so treat it like a password: don’t paste it anywhere else, and revoke the key in your dashboard if it leaks. On Team and Enterprise plans, an owner has to add the connector for the organization first. Connectors you add on claude.ai also show up in the Claude desktop app.

Claude Code

Run this in your terminal. It sends the key as a header, so it stays out of the URL:

claude mcp add --transport http hollerpost https://mcp.hollerpost.com/mcp --header "Authorization: Bearer hp_live_your_key_here"

The word Bearer and the space after it matter. Run /mcp inside Claude Code to check it says connected.

Claude Desktop (local)

In Claude Desktop, open Settings from the Claude menu, go to Developer and click Edit Config. That opens claude_desktop_config.json. Add this, with your key, then quit Claude Desktop completely and open it again:

{
  "mcpServers": {
    "hollerpost": {
      "command": "npx",
      "args": ["-y", "hollerpost-mcp"],
      "env": {
        "HOLLERPOST_KEY": "hp_live_your_key_here"
      }
    }
  }
}

If you already have other servers in that file, add the "hollerpost" block next to them inside "mcpServers".

Cursor

Add this to .cursor/mcp.json in your project (or ~/.cursor/mcp.json for every project). It reads your key from the HOLLERPOST_KEY environment variable, so the key stays out of the file:

{
  "mcpServers": {
    "hollerpost": {
      "url": "https://mcp.hollerpost.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:HOLLERPOST_KEY}"
      }
    }
  }
}

Rather run it locally? The same block from the Claude Desktop section works in Cursor’s mcp.json too.

ChatGPT

ChatGPT adds remote MCP servers from its Plugins page on the web. Open chatgpt.com/plugins, select the plus button, then Add custom MCP server. Give it a name, paste the remote URL under Connection, and create it as a plugin. Your account or workspace settings decide whether you can add one.

ChatGPT can’t send a custom header, so put your key in the URL instead and choose no authentication:

https://mcp.hollerpost.com/mcp?key=hp_live_your_key_here

The server never writes keys to its logs, but anyone who sees that URL can use the key, and a URL is easier to leak than a header. So make a key just for ChatGPT, leave Send unchecked unless you need it, and revoke it if you stop using it. Any other assistant that can’t send headers can use this too, or run the local npx setup instead.

If it won’t connect

  • Claude.ai or Claude Desktop connector: use the URL with ?key= and remove any request header or OAuth settings. Delete the connector and add it again if you changed it.
  • Check the key: it starts with hp_live_ or uc_live_, has no spaces, and hasn’t been revoked. If you’re not sure, make a new key and copy the connector URL it shows you.
  • Header setups: the value is Bearer, a space, then the key.
  • Still stuck? Email support@hollerpost.com with the time you tried and which assistant you used (never the key). We can see each connection attempt and tell you what went wrong.

Scopes

Each API key has scopes that decide what it can do. A new key starts with read, contacts, draft and account. That’s enough to set up your account and draft campaigns, and none of it can send to your list or spend money. Change them when you make the key.

ScopeLets the keyOn by default
readSee your workspace, brand, templates, tags, contacts, campaigns, stats and events.Yes
contactsAdd contacts (with consent).Yes
draftDraft and edit campaigns, preview them, send tests to your team, and save brand voice notes. Also store pictures for emails, and edit your page, launch page and calendar events (publishing still needs your yes).Yes
sendSchedule and cancel campaigns, and send one-off emails.No
webhooksAdd, list and remove webhooks.No
accountChange your workspace name, from name, reply-to and footer address; add, check and remove sending domains; fill in, check and submit your texting registration; get a billing portal link.Yes

About send

It lets the key schedule campaigns to your whole list. Only turn it on for tools you trust. Without it, your assistant can draft and test as much as it likes, and you schedule the send yourself in the dashboard.

If a tool needs a scope the key doesn’t have, it gets 403 insufficient_scope and your assistant tells you which scope was missing. Nothing happens.

Tools

These are the tools your assistant sees. “Scope” is what the API key needs for that tool, and “Uses sends” means it counts toward your plan’s monthly emails.

ToolWhat it doesScopeUses sendsCan you undo it
workspace_infoWho you are: workspace, plan, scopes and brand, in one call.readNoRead only
brand_getYour logo (and dark-mode logo), colors, theme, info bar, footer, social links, voice notes and sending domain.readNoRead only
brand_set_voiceSaves notes on how your emails should sound.draftNoYes, save new notes
brand_set_footerSaves the footer every email carries: link buttons, Follow us icons and a small disclaimer.draftNoYes, save the old footer
brand_set_themeSaves the email look: colors, button style and shape, the dark-mode logo, and the info bar at the top.draftNoYes, save the old look
templates_listYour templates and what each one needs filled in.readNoRead only
segments_listYour tags and how many subscribed people have each.readNoRead only
contacts_searchFinds contacts by email, status or tag.readNoRead only
contacts_addAdds or updates one contact. Only works when the person agreed to hear from you.contactsNoNot from chat. Edit them in your dashboard
email_image_uploadStores a picture for your emails, from a public link or the file itself, and gives back its address.draftNoNothing is sent. The picture stays in your image library
email_image_upload_linkMakes a one-time page where you upload pictures from your own device. The link works once, for 30 minutes.draftNoNothing is sent
email_images_listPictures already stored for your emails, newest first, so they can be reused.readNoRead only
campaign_draftMakes a new draft campaign from a template, with a subject, content and audience. It can also ask one survey question that people answer with one click.draftNoNothing is sent. Drafts can be edited
campaign_updateEdits a draft, including adding or removing its survey question.draftNoYes, edit it again
campaign_previewShows the finished email, how many people it goes to, what that leaves of your sends, and any warnings.draftNoRead only
campaign_send_testSends a test to up to 3 people on your workspace.draftYes, one per test emailNo, it’s sent
campaign_scheduleSchedules a draft to send now or later. Needs the send scope.sendYes, one per personYes, with campaign_cancel, until it starts sending
campaign_cancelCancels a scheduled campaign before it sends.sendNoYes, schedule it again
campaigns_listLists your campaigns, by status.readNoRead only
campaign_statsSent, delivered, bounced, opened, clicked, unsubscribed, and the top links.readNoRead only
email_sendSends one email to one person, like a receipt or a reply. Needs the send scope.sendYes, oneNo, it’s sent
events_recentRecent events: signups, unsubscribes, bounces, complaints.readNoRead only
surveys_listYour surveys, their questions, response counts and the share link for open ones.readNoRead only
survey_resultsTotals for one survey: answer counts, average rating, recommend score and the latest written answers. No names.readNoRead only
survey_createMakes a new survey as a draft. Nobody sees it until it’s opened.draftNoYes, edit or close it
survey_updateEdits a survey, or opens or closes it. Open it before a campaign that asks one of its questions goes out.draftNoYes, close or edit it
page_getYour page: its links, events, handle, and whether it’s published.readNoRead only
page_updateEdits your page. Publishing needs your yes; until then, edits to a live page wait as a draft and the public page stays as it was.draftNoYes, edit it again
page_link_addAdds a link to your page (up to 30).draftNoYes, with page_link_remove
page_link_updateEdits one link on your page.draftNoYes, edit it again
page_link_removeRemoves a link from your page. Asks for confirmation.draftNoNo. Add it again
page_links_reorderChanges the order of the links on your page.draftNoYes, reorder them again
event_listYour calendar events, upcoming and from the past 90 days.readNoRead only
event_createAdds a calendar event. It stays a draft unless you say to show it on your page.draftNoYes, edit or cancel it
event_updateEdits a calendar event. Changes to an event already on your page wait for your yes.draftNoYes, edit it again
event_cancelCancels an event and takes it off your page. Asks for confirmation.draftNoNo. Make a new event
launchpad_getYour launch page: signups, confirmed people, the share link, and the saved launch note and first button.readNoRead only
launchpad_updateSaves the launch page’s headline, pitch, launch note and first button as a draft. Can also build the whole page from blocks (the advanced editor). Doesn’t publish anything.draftNoYes, edit it again
launchpad_go_livePuts your launch page live after you say yes. Automatic checks run first, and it may be held for review. Sends no email.draftNoYes, switch it back to waitlist with launchpad_update
launchpad_set_offlineTakes your launch page offline after you say yes, or puts it back. Visitors go to Your page (or hollerpost.com) while it is offline. Your signups and design stay.draftNoYes, run it again with the other setting
launchpad_domain_setShows your launch page at your own subdomain, like join.yourbusiness.com, after you say yes. Gives you the one DNS record to add.draftNoYes, with launchpad_domain_remove
launchpad_domain_removeStops showing your launch page at your own address. Your hollerpost.com address keeps working. Asks for confirmation.draftNoYes, set it again with launchpad_domain_set
account_getYour plan, sends used this month, and billing date.readNoRead only
account_updateChanges your workspace name, from name, reply-to or footer address.accountNoYes, change it back
domain_addAdds a sending domain and returns the DNS records to put in.accountNoYes, with domain_remove
domain_listYour sending domains and whether each is verified.readNoRead only
domain_verifyChecks your DNS records now and says which ones are right and which are wrong.accountNoRead only
domain_removeRemoves a sending domain. Asks for confirmation, and won’t remove one a scheduled campaign is using.accountNoNo. Add it again and redo the DNS records
sms_setup_statusWhere your texting number’s carrier registration stands, what’s left to do, and how to fix a rejection.readNoRead only
sms_registration_updateFills in or fixes your texting registration form, while it’s a draft or after a rejection. Your business registration number is entered in the dashboard only.accountNoYes, change it again before you submit
sms_website_checkRuns the carriers’ checks on your form, website, privacy policy and terms, and lists what to fix.accountNoNothing to undo
sms_numbersToll-free numbers you can pick for texting.accountNoRead only
sms_registration_submitSends your registration to the carriers after you say yes. The first time, it also gets the toll-free number you picked (included in your add-on). Every check runs again first.accountNoNo. The carriers review it; you can fix and resubmit after a rejection
billing_portal_linkGives you a link to your billing page. You open it and make any changes there.accountNoNothing changes from chat

Safety

The point is that an assistant can do the busy work without being able to surprise you. These rules are in the server and the API, not just in the tool descriptions:

  • Preview before schedule. Your assistant is told to preview a campaign and show you the audience count and the sends it uses before it schedules anything. Scheduling needs an explicit confirmation and that audience count. If your list changed by more than 5% since the preview, the schedule is refused and your assistant gets the new count to show you.
  • A person reviews your first campaign. The first campaign from a new workspace is reviewed by a person before it sends. An assistant can’t skip that; it’s told the review is pending.
  • Consent to add contacts. Adding a contact requires confirming the person agreed to hear from you. Anyone who unsubscribed or bounced stays that way.
  • Tests go to your team. Test sends only go to people on your workspace, never to an address the assistant picks.
  • No billing changes. No tool can change your plan, buy a send pack or touch a card. The only billing tool hands back a link to your billing page, and a person opens it.
  • Removals ask first. domain_remove, page_link_remove and event_cancel are the only tools that remove anything, and each needs confirmation. There’s no tool to delete contacts, campaigns or webhooks.

Limits

Each key can make 600 requests a minute, the same as the API. If your assistant goes over, the server waits and tries once more, then tells it to slow down.

Emails sent through the MCP server count toward your plan’s monthly sends, the same as campaigns you send from the dashboard. On Free that’s 1,000 emails a month. The MCP server itself costs nothing extra.

Stuck? Email support@hollerpost.com. It comes to me.

Sources

The setup steps above were checked against each app’s own docs. Apps move their menus now and then; if a button has moved, these pages will have the current name.

  • Claude Help Center, Getting started with custom connectors using remote MCP, https://support.claude.com/en/articles/11175166-getting-started-with-custom-connectors-using-remote-mcp, checked 2026-11-02 (the key-in-URL setup tested end to end).
  • Model Context Protocol, Connect to local MCP servers (Claude Desktop), https://modelcontextprotocol.io/docs/develop/connect-local-servers, checked 2026-10-04.
  • Cursor Docs, Model Context Protocol, https://cursor.com/docs/context/mcp, checked 2026-10-04.
  • OpenAI, Connect and test your plugin, https://developers.openai.com/plugins/deploy/connect-chatgpt, checked 2026-11-04.
hollerpost

Email and texts for small business, built and backed by a real person.

Questions? support@hollerpost.com

Follow along on Instagram, X and Threads.

Features

  • Launchpad
  • Your page
  • Text updates
  • Integrations
  • How our AI works

Hollerpost

  • Pricing
  • Guides
  • How-to videos
  • Switch from Mailchimp
  • Hollerpost vs Mailchimp
  • Support
  • Status
  • Log in
  • Privacy
  • Terms
  • Copyright
  • Affiliates

Hollerpost is a service of Utopian Creations LLC, 850 Campus Dr #103, Daly City, CA 94015. © 2026 Utopian Creations LLC.