Connect Mailprompt to an MCP client

The Mailprompt MCP server exposes the same 36 tools as the Studio assistant: account overview, catalog, segments, flows, campaigns, email copy, images, coupons, forms, results, audits, suggestions and approval requests.

Hosted connector (OAuth)

The hosted server is a stateless Streamable HTTP endpoint at https://app.mailprompt.ai/api/mcp. It accepts POST only; a GET returns 405. Authentication is OAuth 2.1 with dynamic client registration, PKCE and a consent screen, so a client only ever holds a scoped token rather than an account key.

1. Add https://app.mailprompt.ai/api/mcp as a connector in the client.
2. The client discovers the authorization server from the protected-resource metadata and registers itself.
3. Sign in to Mailprompt and approve the requested scopes. Only an owner or admin can authorize a connector.
4. The client receives a one-hour access token and a rotating refresh token.

Clients request the read-only scopes by default: profiles:read, flows:read, campaigns:read, results:read. The authorization server advertises the full set below so a write scope can be granted deliberately.

Revoking the connector in the client stops new tokens. An owner can also remove the client from the account. Each authorization emails the owner, so an unexpected connector is visible.

Local stdio package

The local server runs on your machine and proxies to the public API through the SDK. It reads MAILPROMPT_API_KEY and, optionally, MAILPROMPT_API_URL (default https://api.mailprompt.ai). A capability with no API endpoint answers tool_unavailable_in_stdio instead of pretending to work; use the hosted connector for those.

npx -y @mailprompt/mcp

Read-only keys are the safer default for a local client. A key with write scopes can create drafts, and a key with no approval capability still cannot approve.

Claude Desktop

Add the server to the Claude Desktop configuration file, then restart the app. On macOS the file is ~/Library/Application Support/Claude/claude_desktop_config.json; on Windows it is %APPDATA%\Claude\claude_desktop_config.json.

{
  "mcpServers": {
    "mailprompt": {
      "command": "npx",
      "args": ["-y", "@mailprompt/mcp"],
      "env": {
        "MAILPROMPT_API_KEY": "mp_live_your_key"
      }
    }
  }
}

Claude Code

Use the CLI to register the local server with its environment variable:

claude mcp add mailprompt \
  -e MAILPROMPT_API_KEY=mp_live_your_key \
  -- npx -y @mailprompt/mcp

Or add the hosted connector and complete the OAuth consent flow in the browser:

claude mcp add --transport http mailprompt https://app.mailprompt.ai/api/mcp

Cursor

Add the hosted connector to .cursor/mcp.json in the project (or the global Cursor config). Cursor opens the consent screen the first time the server is used.

{
  "mcpServers": {
    "mailprompt": {
      "url": "https://app.mailprompt.ai/api/mcp"
    }
  }
}

For the local package, use the same mcpServers block as Claude Desktop.

Tool list

Generated from the shared tool registry, so the list cannot drift from what the server actually exposes. 14 of 36 tools can cost credits and take a confirm flag.