@sendrealm/mcp
v0.1.3
Published
MCP server for the Sendrealm public API.
Readme
Sendrealm MCP
@sendrealm/mcp exposes SendRealm's public API to MCP clients. It is draft-safe: campaign scheduling, campaign sending, direct email sending, and broad direct push sending are intentionally not MCP tools. Agents can send an explicit test to one selected push device and inspect its delivery trace.
Push integration testing
The push tools can create or inspect a push app, report provider readiness without returning credentials, find registered devices, inspect notification events, create and edit push campaign drafts, preview reachable audiences, and send a real test to one device. Live Activity test tools are also restricted to an explicitly selected device at start.
Provider credential uploads and production campaign launch remain dashboard-only.
Hosted connection
Connect an MCP client to https://mcp.sendrealm.com/mcp with the header:
Authorization: Bearer your_sendrealm_api_key
X-Sendrealm-Project-Id: optional_authorized_project_idThe hosted server uses stateless Streamable HTTP. It validates the API key for every request, does not persist it, and forwards it only to the SendRealm public API.
Local stdio
SENDREALM_API_KEY=your_sendrealm_api_key \
SENDREALM_PROJECT_ID=optional_authorized_project_id \
npx -y @sendrealm/mcpSet SENDREALM_PROJECT_ID to override the key's default project and SENDREALM_BASE_URL for a non-production API endpoint.
Hosted runtime
SENDREALM_MCP_PUBLIC_URL=https://mcp.sendrealm.com \
SENDREALM_MCP_ALLOWED_HOSTS=mcp.sendrealm.com \
SENDREALM_MCP_ALLOWED_ORIGINS=https://app.sendrealm.com,https://chatgpt.com,https://claude.ai \
SENDREALM_MCP_BIND_HOST=0.0.0.0 \
SENDREALM_MCP_PORT=3000 \
npm startThe /mcp endpoint requires a Bearer API key, validates Host and Origin headers, and limits JSON request bodies to 1 MB by default.
Release order
Publish @sendrealm/[email protected] before publishing or deploying this package. The MCP server relies on the SDK's project, domain, campaign, and push resources.
