All notes

MCP · November 9, 2026

Post a newsletter issue from the MCP

create_newsletter_issue saves the HTML. publish_newsletter_issue sends it to confirmed readers. The subscribe page is still a separate call.

create_newsletter opens the public page and returns its link. It does not send an issue. Saving the letter and sending it are two later calls. A sending key is enough for both. Creating or verifying a domain still needs a full-access key. The From address is the one stored on the newsletter.

Save the issue

create_newsletter_issue needs the newsletter id, a name of up to 80 characters, a subject of up to 200 characters, and the HTML. Plain text is optional. When you leave it out, Pigeon derives it from the HTML. {{name}} and {{email}} are filled for each reader when the issue goes out. The saved issue is a draft. Pass scheduled_at as an ISO 8601 time in the future and the status stays scheduled.

shell
Use create_newsletter_issue on newsletter <id>.
Name: Sunday notes.
Subject: What shipped this week.
HTML is a short letter that greets {{name}}.
Reply with the issue id. Do not send it yet.

Send it

publish_newsletter_issue takes that newsletter id and the issue id from the save. It sends to confirmed readers. Publishing an issue whose scheduled_at is still in the future returns sent 0 and leaves the status scheduled. The scheduler sends it when that time arrives. Publishing an issue that is already sent is refused.

shell
Use publish_newsletter_issue for newsletter <id> and issue <campaign_id>.
Send it to confirmed readers.

One issue of Pigeon notes was posted with these two calls.

Open Pigeon notes

The same calls on the API

POST /api/newsletters/:id/campaigns writes the issue. The 201 body includes id and status. POST /api/newsletters/:id/campaigns/:campaign_id/publish sends it. A sent issue answers 422.

shell
curl -X POST https://pigeonfs.com/api/newsletters/$NEWSLETTER_ID/campaigns \
  -H "Authorization: Bearer $PIGEON_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Sunday notes","subject":"What shipped this week","html":"<p>Hello {{name}}</p>"}'

curl -X POST https://pigeonfs.com/api/newsletters/$NEWSLETTER_ID/campaigns/$CAMPAIGN_ID/publish \
  -H "Authorization: Bearer $PIGEON_API_KEY"
MCP server guide Newsletter guide Ask Grok for a newsletter