@ractermx/mcp-server

用于通过 AI 助手管理 RacterMX 邮件转发的 MCP 服务器。

设置

npm install

Related MCP server: Email MCP Server

配置

设置环境变量：

• RACTERMX_API_KEY（必需）— 来自 RacterMX 的 sk_* API 密钥

• RACTERMX_API_URL（可选）— 默认为 https://ractermx.com

与 Kiro / Claude Desktop 配合使用

添加到你的 MCP 配置：

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

可用工具（共 111 个）

所有工具均面向 V2 API（/api/v2）。

必需的 API 密钥范围

每个工具组都需要 API 密钥具有特定范围：

创建包含全部 21 个范围的 API 密钥可获得完整访问权限，或仅限特定范围用于受限集成。

仪表盘与统计（5）

• get_dashboard — 仪表盘统计概览

• get_statistics — 聚合邮件统计

• get_daily_statistics — 按日细分的图表数据

• get_statistics_by_domain — 按域名分组的统计数据

• get_quota — 账户配额与使用限制

域名（9）

• list_domains — 列出所有转发域名

• get_domain — 获取域名详情

• add_domain — 添加新域名

• update_domain — 更新域名设置

• delete_domain — 删除域名

• verify_domain_dns — 触发 DNS 验证

• get_domain_dns_records — 获取所需的 DNS 记录

• get_domain_statistics — 获取每个域名的邮件统计

• get_domain_health — SPF/DKIM/DMARC/MX 状态

域名通配符（2）

• enable_wildcard — 启用子域名通配转发

• disable_wildcard — 停用子域名通配转发

域名标签（6）

• list_tags — 列出所有标签

• create_tag — 创建标签

• update_tag — 更新标签

• delete_tag — 删除标签

• assign_tags_to_domain — 为域名分配标签

• remove_tag_from_domain — 从域名移除标签

域名通知偏好（2）

• get_notification_preferences — 获取静音/取消静音设置

• set_notification_preferences — 设置静音/取消静音设置

域名转移（2）

• initiate_domain_transfer — 发起转移

• cancel_domain_transfer — 取消待处理的转移

组织（10）

• list_organizations — 列出组织树（可选择包含域名/评分）

• create_organization — 创建子组织

• update_organization — 重命名或更改上级组织

• delete_organization — 删除组织

• list_organization_members — 列出成员

• invite_to_organization — 邀请用户

• remove_organization_member — 移除成员

• list_organization_domains — 列出组织内的域名

• move_domain_to_organization — 移动域名

• bulk_move_domains — 批量移动多个域名

域名安全 / DoSPM（8）

• get_security_checks — 按支柱分组的全部检查结果

• get_security_score — 最新态势评分与等级

• trigger_security_scan — 按需扫描（速率限制为每小时 1 次）

• get_security_history — 评分历史（最多 365 天）

• apply_security_fix — 应用建议的区域修复

• acknowledge_drift — 确认漂移事件

• get_check_catalog — 完整检查目录

• set_check_override — 覆盖每个域名的检查严重级别

DNS 区域记录（4）

• list_zone_records — 列出所有区域记录

• create_zone_record — 创建 DNS 记录

• update_zone_record — 更新 DNS 记录

• delete_zone_record — 删除 DNS 记录

别名（8）

• list_aliases — 列出域名的别名

• list_all_aliases — 跨所有域名的全局别名列表

• get_alias — 获取别名详情

• create_alias — 创建新别名

• update_alias — 更新别名

• delete_alias — 删除别名

• get_alias_statistics — 每个别名的统计

• export_aliases — 将别名导出为 CSV

• bulk_update_aliases — 批量启用/禁用或更改 forward_to

邮件日志（2）

• list_email_logs — 使用筛选条件搜索邮件日志

• get_email_log — 获取特定日志条目

发送邮件（1）

• send_email — 发送邮件

Webhooks（9）

• list_webhooks — 列出 Webhook 端点

• create_webhook — 创建 Webhook

• update_webhook — 更新 Webhook

• delete_webhook — 删除 Webhook

• test_webhook — 发送测试事件

• get_webhook_secret — 获取签名密钥

• rotate_webhook_secret — 轮换签名密钥

• list_webhook_delivery_logs — 查看投递历史

• retry_webhook_delivery — 重试失败的投递

阻止列表（3）

• list_blocklist — 列出被阻止的发件人

• add_blocklist_entry — 阻止发件人/模式

• remove_blocklist_entry — 取消阻止发件人

API 密钥（3）

• list_api_keys — 列出有效的密钥

• create_api_key — 创建新密钥

• revoke_api_key — 吊销密钥

SMTP 凭据（5）

• list_smtp_credentials — 列出 SMTP 凭据

• create_smtp_credential — 创建 SMTP 凭据

• delete_smtp_credential — 删除 SMTP 凭据

• reset_smtp_password — 重置密码

• set_smtp_reply_from — 设置回复来源别名

保留策略（2）

• get_retention_policy — 查看保留设置

• update_retention_policy — 更新保留策略

匿名回复（2）

• list_anonymous_replies — 列出代理地址

• disable_anonymous_reply — 禁用代理

通知（4）

• list_notifications — 列出仪表盘通知

• mark_notification_read — 将一条标记为已读

• mark_all_notifications_read — 将所有标记为已读

• delete_notification — 删除通知

信誉（6）

• get_reputation_score — 综合评分与等级

• get_reputation_blacklists — 当前及历史列名情况

• get_reputation_deliverability — 退信/垃圾邮件/拒收指标

• get_reputation_ips — 按 IP 的信誉数据

• get_reputation_trends — 时间序列图表数据

• get_reputation_recommendations — 可操作的建议

DMARC（6）

• list_dmarc_reports — 列出汇总报告

• get_dmarc_report — 包含记录的完整报告详情

• get_dmarc_sources — 来源分析（谁以你的名义发送）

• get_dmarc_compliance — 合规率与建议

• export_dmarc_report — 将报告导出为 XML

• apply_dmarc_policy — 更改 DMARC 策略（none/quarantine/reject）

警报规则（7）

• list_alert_rules — 列出规则

• create_alert_rule — 创建规则

• get_alert_rule — 获取规则详情

• update_alert_rule — 更新规则

• delete_alert_rule — 删除规则

• get_alert_rule_history — 触发历史

• test_alert_rule — 发送测试警报

合规导出（2）

• trigger_compliance_export — 触发导出（每 24 小时 1 次）

• get_compliance_export_status — 检查状态/下载 URL

搜索与速率限制（2）

• search — 跨域名、别名、日志的统一搜索

• get_rate_limit_status — 当前 API 速率限制状态