MCP server

Connect Grok, Cursor, or Claude Code, then use the prompts on this page. create_newsletter returns the public page link.

github.com/pigeonfs/pigeon-mcp

Install

shell
npm install github:pigeonfs/pigeon-mcp

Configure Grok

shell
# Save this in ~/.grok/config.toml
[mcp_servers.pigeon]
command = "npx"
args = ["-y", "github:pigeonfs/pigeon-mcp"]
enabled = true

[mcp_servers.pigeon.env]
PIGEON_API_KEY = "pg_your_key"
PIGEON_BASE_URL = "https://pigeonfs.com"
SENDER_EMAIL_ADDRESS = "ada@yourdomain.com"

Keep the key in that file. Reload the editor after you save it. A full-access key can add a domain and call verify_domain, which rechecks the DNS records. A sending key can send mail, add a contact, and create a newsletter. SENDER_EMAIL_ADDRESS is the default From, on a domain you already verified.

Cursor

JavaScript
{
  "mcpServers": {
    "pigeon": {
      "command": "npx",
      "args": ["-y", "github:pigeonfs/pigeon-mcp"],
      "env": {
        "PIGEON_API_KEY": "pg_your_key",
        "PIGEON_BASE_URL": "https://pigeonfs.com",
        "SENDER_EMAIL_ADDRESS": "ada@yourdomain.com"
      }
    }
  }
}

Claude Code

shell
claude mcp add pigeon \
  -e PIGEON_API_KEY=pg_your_key \
  -e PIGEON_BASE_URL=https://pigeonfs.com \
  -e SENDER_EMAIL_ADDRESS=ada@yourdomain.com \
  -- npx -y github:pigeonfs/pigeon-mcp

Prompts

Ask in your own words. These prompts name the call so the editor uses Pigeon.

shell
Use Pigeon to create the sending domain yourdomain.com.
Show the DNS records from the response, then tell me which ones I still have to publish.

Publish those records at the company that hosts the domain. When they answer, ask:

shell
Use Pigeon to list my domains.
If yourdomain.com is not verified, verify it and tell me what is still missing.
shell
Use create_newsletter for a letter named Sunday Notes.
From is Ada <ada@yourdomain.com>.
Description: A short letter about the product.
Use the sea design.
Reply with the public page link.

create_newsletter calls POST /api/newsletters and returns url, the subscribe page. Readers confirm from the message. A later publish call sends the issue.

shell
Draft a short welcome email for a person named Ada.
Send it with Pigeon to me@yourdomain.com, subject "Welcome", using the default from address.

send_email delivers html or text. When you leave From out, it uses SENDER_EMAIL_ADDRESS. Save that HTML as a template in the dashboard when you want a slug such as welcome.

shell
List my Pigeon domains and say which ones are still pending.
Then list the last emails with status queued.
  • send_email, list_emails, get_email, and cancel_email
  • list_domains, create_domain, and verify_domain. Creating and verifying a domain uses a full-access key.
  • create_contact
  • trigger_automation, with the id of an automation you already saved
  • list_newsletters, create_newsletter, get_newsletter, create_newsletter_issue, and publish_newsletter_issue

Create a newsletter

shell
curl -X POST https://pigeonfs.com/api/newsletters \
  -H "Authorization: Bearer pg_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"name":"Pigeon notes","from":"Pigeon <ada@yourdomain.com>","description":"Notes from the API."}'
Newsletter guide All SDK libraries API reference