sparkpost-mcp

MCP server exposing the SparkPost (EU) email API as 20 tools — account, templates, transactional sends, suppression, sending domains, webhooks, subaccounts, message events, deliverability metrics, and recipient lists.

Published on npm as @pcummings/sparkpost-mcp.

Install into an AI agent

You need a SPARKPOST_API_KEY (SparkPost EU dashboard → API Keys). For the US region, also set SPARKPOST_API_BASE=https://api.sparkpost.com/api/v1.

The commands below fetch the server from npm via npx -y @pcummings/sparkpost-mcp. To run from a local clone instead, replace npx -y @pcummings/sparkpost-mcp with npx tsx /absolute/path/to/index.ts.

Claude Code

claude mcp add sparkpost -e SPARKPOST_API_KEY=your-key -- npx -y @pcummings/sparkpost-mcp

Add --scope user to make it available in every project.

OpenAI Codex

codex mcp add sparkpost --env SPARKPOST_API_KEY=your-key -- npx -y @pcummings/sparkpost-mcp

Gemini CLI

gemini mcp add -e SPARKPOST_API_KEY=your-key sparkpost npx -y @pcummings/sparkpost-mcp

US region — append the base-URL env to any command above (-e for Claude/Gemini, --env for Codex):

SPARKPOST_API_BASE=https://api.sparkpost.com/api/v1

Any other MCP client (Claude Desktop, Cursor, Windsurf, VS Code, Cline, Zed …) — add this to the client's MCP config:

{
  "mcpServers": {
    "sparkpost": {
      "command": "npx",
      "args": ["-y", "@pcummings/sparkpost-mcp"],
      "env": { "SPARKPOST_API_KEY": "your-key" }
    }
  }
}

For a local clone, use "args": ["tsx", "/absolute/path/to/index.ts"].

Run from source

npm install
export SPARKPOST_API_KEY=your-key   # required; server exits if missing
export SPARKPOST_API_BASE=...        # optional; defaults to EU. US: https://api.sparkpost.com/api/v1
npm start

Tools

Usage examples

Send an email:

Send a transactional email to alice@example.com from noreply@yourdomain.com with subject "Hello" and body "Hi Alice"

Create a template:

Create an email template with id "welcome", name "Welcome Email", subject "Welcome to {{company}}!", html "Hi {{name}}", from noreply@yourdomain.com

Search recent bounces:

Search message events for bounce events in the last 24 hours for recipient domain example.com

Dev

npm run typecheck   # tsc --noEmit
npm test            # node:test suite (44 tests)