Skip to content
StalkMail

REST API and MCP

Everything the dashboard does is also an API action. The REST API and the MCP server run the same checks: plan limits, sender rules, pre-send checks and account blocks.

Draft documentation. The API and MCP server ship with the beta, and request or response shapes may change before then.

REST API

JSON in and out. Send your key as a bearer token.

https://app.stalkmail.com/api/v1

MCP server

Streamable HTTP. Every action is a tool, with the same permissions.

https://app.stalkmail.com/mcp

Quick start

  1. Create an API key on the API keys page. Keys are shown once.
  2. Send the key as a bearer token.
  3. Call an endpoint. This one lists your newsletters with their settings.
curl https://app.stalkmail.com/api/v1/newsletters \
  -H "Authorization: Bearer $STALKMAIL_API_KEY"

What you can do

  • Newsletter1 endpoint
  • Subscribers5 endpoints
  • Forms (public)2 endpoints
  • Webhooks (Unosend)1 endpoint
  • Campaigns (planned)5 endpoints
  • Domains (planned)3 endpoints
API referenceMCP setup