Email Subject Line Best Practices via API
Best practices for subject lines are well documented — keep them short, lead with value, avoid spam triggers — but acting on them programmatically is the hard part. marginal exposes those practices through an API and MCP tools so an AI agent can generate, test, and pick winners without you wiring up a send stack.
From guidelines to a testable API
Most subject line advice stops at the rule: front-load the offer, stay under ~50 characters, write like a human, skip the all-caps urgency. The trouble is that no single rule reliably beats another across audiences — the only durable best practice is to test on your own list.
The email subject line best practices API in marginal turns those principles into measurable experiments. Instead of guessing which heuristic wins, you generate candidate lines, ship them to a real segment, and let the open and click data decide.
- generate_variants — produce subject line options from a brief or product context
- launch_test — run a subject line A/B test against a managed send
- get_results — read opens, clicks, and within-test lift
- recommend_next — get a data-backed suggestion for the follow-up send
What the data actually tells you
Best practices are starting hypotheses; lift metrics are the verdict. marginal tracks opens and clicks per variant and reports within-test lift so you know whether the shorter line, the question format, or the emoji-free version genuinely moved the needle for this audience.
Because results are scoped to each test, you avoid the common mistake of carrying last campaign's winner into a different segment where it underperforms.
- Compare 2+ variants on the same send and segment
- Measure relative lift rather than raw rates alone
- Feed outcomes back into the next round via recommend_next
Let an AI agent run the loop
marginal is a hosted email MCP server, so any MCP-capable assistant — Cursor, Claude Code, Windsurf, Cline, Continue, Zed, OpenAI Codex, or Claude Desktop — can call these tools directly. That makes AI agent email marketing practical: the agent drafts variants, launches the test, waits for results, and proposes the next subject line.
Connect to the endpoint at https://marginal.sh/mcp with a Bearer API key (marg_live_...). There is nothing to self-host. The free tier covers 100 experiments per month, which is enough to validate subject line best practices on a real list before scaling up.
- Hosted endpoint: https://marginal.sh/mcp
- Auth via Bearer key, no infrastructure to manage
- Works with existing MCP clients and agent workflows
- Docs and setup details at https://marginal.sh/docs/
Get started with marginal
marginal is a hosted email marketing MCP server at marginal.sh. Sign up free, create an API key, and connect https://marginal.sh/mcp from Cursor, Codex, or Claude Desktop.
- 100 experiments/month on the free tier
- Four MCP tools: generate_variants, launch_test, get_results, recommend_next
- Listed in the MCP Registry as sh.marginal/mcp