AI Integration (MCP)

GoodPostal supports the Model Context Protocol (MCP), an open standard that lets AI assistants like Claude, Cursor, VS Code, ChatGPT, Codex, and Devin interact directly with your email marketing workspace. Create templates, manage campaigns, and send test emails using natural language through your favorite AI tool.

What You Can Do

The full GoodPostal MCP server provides 53 tools for command-line AI clients like Claude Code, Cursor, and Codex. Claude on the web and ChatGPT use a curated set of 44 tools. Your AI assistant can use these tools to manage your entire workspace, from templates and campaigns to contacts, branding, sender identities, and tracking domains. Here are some of the most commonly used tools:

Setup

GoodPostal uses OAuth 2.1 for MCP authentication. When you first connect, your browser will open so you can log in and select which workspace to authorize. No API keys or tokens to manage; your AI tool handles the OAuth flow automatically.

Step 1: Add the MCP Server to Your AI Tool

Select your AI tool below for setup instructions.

{
  "mcpServers": {
    "goodpostal": {
      "url": "https://mcp.goodpostal.com/mcp/goodpostal"
    }
  }
}

Step 2: Authorize Your Workspace

The first time your AI tool connects to GoodPostal, your browser will open automatically. You'll be asked to:

1. Log in to your GoodPostal account (if not already signed in)
2. Select a workspace, choose which workspace the AI tool should access (only active workspaces are shown, trial or paid, including Nonprofit; frozen or expired workspaces are not)
3. Authorize, confirm that the AI tool can read and create templates and campaigns in your workspace

Once authorized, your AI tool will remember the connection. You won't need to re-authorize unless you revoke access.

Step 3: Verify Connection

After authorizing, ask your AI tool to "List my GoodPostal templates". If the connection is working, it will use the list_templates tool and return your templates.

Example Prompts

Here are some real-world prompts you can try with your AI assistant:

• "Create a welcome email for new subscribers with our brand colors"
• "Build a monthly newsletter template with a header, article sections for this month's stories, and a footer"
• "Send a test email of my latest template to you@yourcompany.com" (test emails can only go to an address on your own login email's domain)
• "List all my campaigns and their current status"
• "Create a promotional email for our summer sale with a hero image and CTA button"

Available Resources

The MCP server also exposes reference resources that AI tools can read for context when building emails:

Available Prompts

Pre-built prompt templates guide the AI through multi-step workflows:

How It Works

GoodPostal's MCP server uses Streamable HTTP transport with OAuth 2.1 + PKCE authentication. When your AI tool first connects, it discovers the OAuth endpoints automatically via .well-known metadata (RFC 8414 and RFC 9728), registers itself as an OAuth client, and initiates a browser-based authorization flow where you log in and select a workspace. The resulting access token is scoped to that workspace; your AI assistant can only access templates, campaigns, and contacts belonging to the workspace you authorized. API requests are rate-limited to 60 requests per minute. Campaigns created through MCP are always saved as drafts so you can review them before sending. Templates can be created as either a draft or a published template, depending on what you ask for.

Troubleshooting

Next Steps

• Templates, learn about template structure and the visual editor
• Campaigns, understand the campaign workflow from draft to send
• API Reference, REST API for programmatic access beyond MCP