Add the Postmark MCP server to Windsurf

Prerequisites

• Windsurf installed.
• POSTMARK_SERVER_TOKEN — Your Postmark server API token.
• DEFAULT_SENDER_EMAIL — Default verified sender email address.
• DEFAULT_MESSAGE_STREAM — Postmark message stream to send through (e.g., 'outbound').

Setup

{
  "mcpServers": {
    "postmark": {
      "command": "node",
      "args": [
        "/path/to/postmark-mcp/index.js"
      ],
      "env": {
        "POSTMARK_SERVER_TOKEN": "<POSTMARK_SERVER_TOKEN>",
        "DEFAULT_SENDER_EMAIL": "<DEFAULT_SENDER_EMAIL>",
        "DEFAULT_MESSAGE_STREAM": "<DEFAULT_MESSAGE_STREAM>"
      }
    }
  }
}

Gotchas

Windsurf's Cascade reads MCP servers from an "mcpServers" object in ~/.codeium/windsurf/mcp_config.json. Unlike most clients, remote servers are configured with the "serverUrl" field rather than "url", so a config that uses "url" silently fails to connect. Native remote transport is supported without an OAuth flow.