@ractermx/mcp-server

MCP server for managing RacterMX email forwarding via AI assistants.

Setup

npm install

Related MCP server: Email MCP Server

Configuration

Set environment variables:

• RACTERMX_API_KEY (required) — your sk_* API key from RacterMX

• RACTERMX_API_URL (optional) — defaults to https://ractermx.com

Usage with Kiro / Claude Desktop

Add to your MCP config:

{
  "mcpServers": {
    "ractermx": {
      "command": "npx",
      "args": ["-y", "@ractermx/mcp-server"],
      "env": {
        "RACTERMX_API_KEY": "sk_your_key_here"
      }
    }
  }
}

Available Tools (111 total)

All tools target the V2 API (/api/v2).

Required API Key Scopes

Each tool group requires specific scopes on your API key:

Create an API key with all 21 scopes for full access, or limit to specific scopes for restricted integrations.

Dashboard & Statistics (5)

• get_dashboard — Dashboard statistics overview

• get_statistics — Aggregated email statistics

• get_daily_statistics — Daily breakdown for charts

• get_statistics_by_domain — Stats grouped by domain

• get_quota — Account quota and usage limits

Domains (9)

• list_domains — List all forwarding domains

• get_domain — Get domain details

• add_domain — Add a new domain

• update_domain — Update domain settings

• delete_domain — Remove a domain

• verify_domain_dns — Trigger DNS verification

• get_domain_dns_records — Get required DNS records

• get_domain_statistics — Get per-domain email stats

• get_domain_health — SPF/DKIM/DMARC/MX status

Domain Wildcard (2)

• enable_wildcard — Enable wildcard subdomain forwarding

• disable_wildcard — Disable wildcard subdomain forwarding

Domain Tags (6)

• list_tags — List all tags

• create_tag — Create a tag

• update_tag — Update a tag

• delete_tag — Delete a tag

• assign_tags_to_domain — Assign tags to a domain

• remove_tag_from_domain — Remove a tag from a domain

Domain Notification Preferences (2)

• get_notification_preferences — Get mute/unmute settings

• set_notification_preferences — Set mute/unmute settings

Domain Transfers (2)

• initiate_domain_transfer — Initiate a transfer

• cancel_domain_transfer — Cancel a pending transfer

Organizations (10)

• list_organizations — List org tree (with optional domains/scores)

• create_organization — Create a child org

• update_organization — Rename or reparent

• delete_organization — Delete an org

• list_organization_members — List members

• invite_to_organization — Invite a user

• remove_organization_member — Remove a member

• list_organization_domains — List domains in an org

• move_domain_to_organization — Move a domain

• bulk_move_domains — Move multiple domains

Domain Security / DoSPM (8)

• get_security_checks — All check results grouped by pillar

• get_security_score — Latest posture score and grade

• trigger_security_scan — On-demand scan (1/hr rate limit)

• get_security_history — Score history (up to 365 days)

• apply_security_fix — Apply suggested zone fix

• acknowledge_drift — Acknowledge drift event

• get_check_catalog — Full check catalog

• set_check_override — Override check severity per domain

DNS Zone Records (4)

• list_zone_records — List all zone records

• create_zone_record — Create a DNS record

• update_zone_record — Update a DNS record

• delete_zone_record — Delete a DNS record

Aliases (8)

• list_aliases — List aliases for a domain

• list_all_aliases — Global alias list across all domains

• get_alias — Get alias details

• create_alias — Create a new alias

• update_alias — Update an alias

• delete_alias — Delete an alias

• get_alias_statistics — Per-alias statistics

• export_aliases — Export aliases as CSV

• bulk_update_aliases — Bulk enable/disable or change forward_to

Email Logs (2)

• list_email_logs — Search email logs with filters

• get_email_log — Get a specific log entry

Email Sending (1)

• send_email — Send an email

Webhooks (9)

• list_webhooks — List webhook endpoints

• create_webhook — Create a webhook

• update_webhook — Update a webhook

• delete_webhook — Delete a webhook

• test_webhook — Send a test event

• get_webhook_secret — Get signing secret

• rotate_webhook_secret — Rotate signing secret

• list_webhook_delivery_logs — View delivery history

• retry_webhook_delivery — Retry a failed delivery

Blocklist (3)

• list_blocklist — List blocked senders

• add_blocklist_entry — Block a sender/pattern

• remove_blocklist_entry — Unblock a sender

API Keys (3)

• list_api_keys — List active keys

• create_api_key — Create a new key

• revoke_api_key — Revoke a key

SMTP Credentials (5)

• list_smtp_credentials — List SMTP credentials

• create_smtp_credential — Create SMTP credentials

• delete_smtp_credential — Delete SMTP credentials

• reset_smtp_password — Reset password

• set_smtp_reply_from — Set reply-from alias

Retention Policy (2)

• get_retention_policy — View retention settings

• update_retention_policy — Update retention

Anonymous Replies (2)

• list_anonymous_replies — List proxy addresses

• disable_anonymous_reply — Disable a proxy

Notifications (4)

• list_notifications — List dashboard notifications

• mark_notification_read — Mark one as read

• mark_all_notifications_read — Mark all as read

• delete_notification — Delete a notification

Reputation (6)

• get_reputation_score — Composite score and grade

• get_reputation_blacklists — Current and historical listings

• get_reputation_deliverability — Bounce/spam/rejection metrics

• get_reputation_ips — Per-IP reputation data

• get_reputation_trends — Time-series charts data

• get_reputation_recommendations — Actionable recommendations

DMARC (6)

• list_dmarc_reports — List aggregate reports

• get_dmarc_report — Full report detail with records

• get_dmarc_sources — Source analysis (who sends as you)

• get_dmarc_compliance — Compliance rate and recommendations

• export_dmarc_report — Export report as XML

• apply_dmarc_policy — Change DMARC policy (none/quarantine/reject)

Alert Rules (7)

• list_alert_rules — List rules

• create_alert_rule — Create a rule

• get_alert_rule — Get rule details

• update_alert_rule — Update a rule

• delete_alert_rule — Delete a rule

• get_alert_rule_history — Firing history

• test_alert_rule — Send test alert

Compliance Export (2)

• trigger_compliance_export — Trigger export (1/24hr)

• get_compliance_export_status — Check status/download URL

Search & Rate Limits (2)

• search — Unified search across domains, aliases, logs

• get_rate_limit_status — Current API rate limit status