Build with RacterMX

RESTful API, interactive Swagger docs, webhooks, and an MCP server for AI agents. Everything you need to integrate privacy-first email forwarding into your stack.

📖 API Explorer Quick Start →

Get Started

Two ways to integrate with RacterMX

📡

REST API + Swagger

Full OpenAPI 3.0 spec with interactive try-it-out. Manage domains, aliases, email logs, webhooks, blocklists, SMTP credentials, and more.

Open API Explorer →
🤖

MCP Server

Model Context Protocol server for AI agents. Let Claude, GPT, or your own LLM manage email forwarding through natural language.

Learn more →

Authentication

Three supported authentication methods

🔑 API Key (Recommended)

Generate API keys from your dashboard. Pass them as a Bearer token in the Authorization header.

Authorization: Bearer sk_live_abc123...

🍪 Session Auth

For browser-based integrations. Authenticate via the web login and use session cookies with CSRF tokens.

Cookie: ractermx_session=abc123; X-CSRF-TOKEN: ...

Send an Email in Seconds

The RacterMX API follows RESTful conventions. JSON in, JSON out. All endpoints live under /api/v2/ and require authentication.

  • Base URL: https://ractermx.com/api/v2
  • Content-Type: application/json
  • Rate limit: 100 requests/minute
  • All timestamps in UTC (ISO 8601)
# Send an email via the RacterMX API
curl -X POST https://ractermx.com/api/v2/emails/send \
  -H "Authorization: Bearer sk_live_abc123" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "hello@yourdomain.com",
    "to": ["user@example.com"],
    "subject": "Hello from RacterMX",
    "html": "<h1>It works!</h1>"
  }'

# Response
{
  "success": true,
  "message_id": "<abc123@yourdomain.com>"
}

API Endpoint Reference

All endpoints require authentication. Base URL: https://ractermx.com/api/v2

📁 Domains

GET/domainsList all domains
POST/domainsAdd a new domain
GET/domains/{id}Get domain details
PATCH/domains/{id}Update domain settings
DEL/domains/{id}Delete a domain
POST/domains/{id}/verify-dnsVerify DNS records
GET/domains/{id}/dns-recordsGet required DNS records
GET/domains/{id}/statisticsDomain-level statistics

📧 Aliases

GET/domains/{id}/aliasesList aliases for a domain
POST/domains/{id}/aliasesCreate a new alias
GET/aliases/{id}Get alias details
PATCH/aliases/{id}Update an alias
DEL/aliases/{id}Delete an alias

✉️ Email

POST/emails/sendSend an email
GET/email-logsList email logs
GET/email-logs/{id}Get log entry details

🔔 Webhooks

GET/webhooksList webhooks
POST/webhooksCreate a webhook
PUT/webhooks/{id}Replace a webhook
PATCH/webhooks/{id}Update a webhook
DEL/webhooks/{id}Delete a webhook
POST/webhooks/{id}/testSend a test event
GET/webhooks/{id}/delivery-logsView delivery history

🚫 Blocklist

GET/blocklistList blocked senders
POST/blocklistBlock a sender
DEL/blocklist/{id}Unblock a sender

🔐 SMTP Credentials

GET/domains/{id}/smtp-credentialsList SMTP credentials
POST/domains/{id}/smtp-credentialsCreate SMTP credential
DEL/smtp-credentials/{id}Delete credential
POST/smtp-credentials/{id}/resetReset password

📊 Statistics & Quota

GET/statisticsOverall statistics
GET/statistics/dailyDaily breakdown
GET/statistics/by-domainPer-domain statistics
GET/quotaCurrent usage & limits
GET/dashboardDashboard summary

⚙️ Settings

GET/retention-policyGet retention settings
PUT/retention-policyUpdate retention settings
GET/anonymous-repliesList anonymous reply mappings
POST/anonymous-replies/{proxy}/disableDisable a proxy address
GET/api-keysList API keys
POST/api-keysCreate an API key
DEL/api-keys/{id}Revoke an API key

📖 Full Interactive Docs (Swagger)

MCP Server for AI Agents

Let AI manage your email forwarding through natural language

Model Context Protocol

The RacterMX MCP server exposes every API endpoint as a tool that AI agents can call. Connect it to Claude, ChatGPT, or any MCP-compatible client to manage domains, aliases, and email forwarding conversationally.

  • Manage domains and aliases
  • Search and filter email logs
  • Create and test webhooks
  • Monitor statistics and quota
  • Configure SMTP credentials
  • Manage blocklists and retention
// Add to your MCP client config
{
  "mcpServers": {
    "ractermx": {
      "command": "npx",
      "args": ["@ractermx/mcp-server"],
      "env": {
        "RACTERMX_API_KEY": "sk_live_abc123"
      }
    }
  }
}

// Then ask your AI agent:
"List all my domains on RacterMX"
"Create an alias catch-all@mydomain.com"
"Show me email logs from the last hour"