RacterMX

io.github.racter-cisoPublished by GitHub account racter-cisov2.0.1Updated Oct 24, 2026

Manage RacterMX email forwarding — domains, aliases, webhooks, and more — via AI.

Overview

AI-generated overview

Lets an assistant manage RacterMX email forwarding — domains, aliases, DNS records, webhooks, logs, and reputation — through the RacterMX API.

What you can do
Exposes 111 tools covering the RacterMX V2 API for email forwarding administration. It can list, add, update, and delete domains and aliases, manage DNS zone records, wildcard forwarding, tags, and organizations, and handle webhooks including secrets and delivery retries. It also reads dashboard statistics, email logs, quota, reputation, DMARC reports, and security posture, and can send email, manage SMTP credentials, blocklist entries, API keys, retention policy, notifications, and alert rules.
When to use it
Useful when you administer RacterMX email forwarding and want an assistant to inspect or change configuration — checking domain health, DNS records, logs, or reputation, and performing bulk alias or domain operations — instead of using the web dashboard.
Requirements
Runs locally as an npm package over stdio, typically via npx, so Node.js is needed. Requires a RacterMX API key in the RACTERMX_API_KEY environment variable; the optional RACTERMX_API_URL variable overrides the default API base URL. The API key must carry the scopes for the tool groups you intend to use.
Before you install
The API key is a secret and grants account access; scope it to only what you need rather than all 21 scopes. Many tools write, change, or delete data, including domains, aliases, DNS records, webhooks, API keys, SMTP credentials, and DMARC policy, and send_email sends real mail. Some tools expose secrets such as webhook signing secrets and SMTP passwords, and compliance exports produce download URLs.

Installation

In SourceWeft

  1. Open RacterMX in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

@ractermx/mcp-server

MCP server for managing RacterMX email forwarding via AI assistants.

Setup

bash
npm install

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:

json
{  "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:

Tool GroupRequired Scope
Dashboard, Statistics, Email Logs, Search, Quota, Rate Limitemail:read
Email Sendingemail:send
Domains, Tags, Organizations, Verification, Transfers, Security, Check Catalog, Reputation, DMARCdomains:read / domains:manage
Aliasesaliases:read / aliases:manage
SMTP Credentials, Anonymous Repliessmtp:read / smtp:manage
Webhookswebhooks:read / webhooks:manage
Blocklistblocklist:read / blocklist:manage
API Keys, Compliance Exportapi-keys:manage
Retention Policyretention:read / retention:manage
DNS Zone Recordsdns-zone:read / dns-zone:manage
Notificationsnotifications:read / notifications:manage
Alert Rulesalerts:read / alerts:manage

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

Source: README.md at commit b289c03

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v2.0.1LatestSep 16, 2026

Score

40% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.