Unspam MCP

官方

为您的AI助手提供安全、通俗易懂的Unspam访问权限:垃圾邮件检测、收件箱位置、截图、热力图以及定期自动测试。通过OAuth连接,无需复制API密钥。

你可以用 Unspam MCP 做什么?

  • 运行垃圾邮件检查 — 启动检查,然后通过 start_spam_check 和 get_spam_check_result 获取评分、SPF、DKIM 和 DMARC 信号,以及截图和热图。
  • 测试收件箱投递情况 — 向返回的种子地址发送一封邮件,查看每个邮箱将其归入收件箱、其他标签页、垃圾邮件还是未收到。
  • 在真实客户端中预览 — 在套餐包含的设备上渲染邮件,并标记特定客户端中的渲染问题。
  • 验证邮件列表 — 检查最多 100,000 个地址,并获取每个地址的状态、原因和建议操作。
  • 设置 DMARC 监控 — 注册域名,获取要发布的 TXT 记录并验证,然后查看细化到每个源 IP 的汇总报告。
  • 安排定期测试 — 连接并测试 SMTP 发件方,然后设置计划、邮箱、检查项和提醒规则,以便自动执行测试。

文档

在 AI 助手中测试电子邮件。

Unspam MCP 服务器为 Claude、ChatGPT、Cursor 和其他 MCP 客户端提供 44 种工具,可用于垃圾邮件检查、收件箱投递情况、客户端预览、电子邮件验证、DMARC 报告和自动化测试,无需复制 API 密钥。

查看价格 阅读文档

用日常语言提问。助手会选择合适的工具。

下面的每段对话都使用真实的 Unspam 工具。回复仅为示例。

垃圾邮件检查 收件箱投递情况 客户端预览 电子邮件验证 DMARC 报告 自动化测试

在聊天中为电子邮件评分

助手会启动检查,并告诉你要发送到哪个地址。结果出来后,它会逐项解释评分信号,还可以调取截图以及注意力和焦点热图。

垃圾邮件检查 API

对话示例

运行垃圾邮件检查,完成后告诉我。

  • start_spam_check
  • get_spam_check_result
  • get_spam_check_screenshots
  • get_spam_check_heatmap

完成。得分为 85 分(满分 100),SPF、DKIM 和 DMARC 均通过。

查看邮件被各邮箱放到了哪里

你只需向它返回的种子地址发送一封电子邮件,并在主题或正文中加入测试 ID。随后,它会报告每个邮箱中的邮件文件夹:收件箱、其他标签页、垃圾邮件或未收到。

收件箱投递情况 API

对话示例

在我的所有邮箱中启动收件箱投递测试,并总结邮件的投递位置。

  • list_mailboxes
  • start_inbox_placement_test
  • get_inbox_placement_result

你的邮件已送达 Gmail 和 Yahoo 的收件箱,但被 Outlook 放进了垃圾邮件。

在真实邮件客户端中渲染电子邮件

你可以使用已完成测试中的邮件、粘贴的 HTML,或发送给你的邮件进行渲染;可以覆盖套餐包含的所有设备,也可以只选择指定设备。

电子邮件预览 API

对话示例

渲染这封营销邮件,并指出 Outlook 深色模式下的任何问题。

  • list_client_preview_devices
  • create_client_preview
  • list_client_previews

Outlook 深色模式的渲染结果显示,白色文字出现在白色页眉上。其他设备上的显示正常。

发送前清理邮件列表

验证单个地址或最多包含 100,000 个地址的列表。每条结果都包含状态、原因、建议操作以及可能的拼写建议。只有明确的结果才会消耗额度。

电子邮件验证 API

对这 300 个地址进行检查,并告诉我哪些应该移除。

  • create_email_list
  • get_email_list
  • get_email_list_results

有 22 个地址无法投递,请移除这些地址。另有 5 个地址存在风险,建议审核。

查明哪些发件人使用你的域名发送邮件

注册域名,获取要发布的 TXT 记录,并通过实时 DNS 检查进行验证。之后,你可以询问哪些发件人使用你的域名发送邮件,助手会读取汇总报告,细化到每个来源 IP。

DMARC 监控

为 yourdomain.com 设置 DMARC 监控,并告诉我需要发布什么 DNS 记录。

  • create_dmarc_domain
  • get_dmarc_dns_instructions
  • verify_dmarc_domain

请在 _dmarc.yourdomain.com 上发布此 TXT 记录。记录生效后告诉我,我会进行验证。

按计划定期运行测试

它会连接并测试你的 SMTP 发件人,根据你的内容构建邮件或捕获你发送的邮件,然后设置计划、邮箱、启用的检查项和提醒规则。它还可以立即运行测试并读取运行历史记录。

自动化收件箱投递测试

使用我的 SMTP 发件人设置每周自动测试,如果有任何邮件进入垃圾邮件文件夹,就发邮件通知我。

  • create_scheduled_test_sender
  • test_scheduled_test_sender_connection
  • create_scheduled_test
  • configure_scheduled_test

每周测试已启用。如果有邮件进入垃圾邮件文件夹,你会收到电子邮件通知。

工具

44

工具组

7

登录方式

OAuth 2.1

速率限制

每分钟 100 次

将其添加到你的客户端。

服务器 URL 在所有客户端中都相同。你的客户端会打开一次浏览器,让你登录并批准访问。

Claude Code Cursor Claude Desktop ChatGPT Windsurf 其他客户端

claude mcp add --transport http unspam https://api.unspam.email/mcp

# then run /mcp in a session and sign in
{
  "mcpServers": {
    "unspam": {
      "url": "https://api.unspam.email/mcp"
    }
  }
}

# add to ~/.cursor/mcp.json, then click Login under Settings, MCP
https://api.unspam.email/mcp

# Settings, Connectors, Add custom connector, then paste this URL
https://api.unspam.email/mcp

# Settings, Apps, turn on Developer mode, then add a custom app with this URL and OAuth
{
  "mcpServers": {
    "unspam": {
      "serverUrl": "https://api.unspam.email/mcp"
    }
  }
}

# add to ~/.codeium/windsurf/mcp_config.json, then refresh the Cascade MCP panel
npx -y mcp-remote https://api.unspam.email/mcp

# any remote MCP client takes the URL; this bridge is for clients that only support stdio

团队为何通过 MCP 连接 Unspam。

通过 OAuth 使用远程 MCP,无需管理密钥。

服务器通过 HTTP 使用 JSON-RPC 2.0,并通过 OAuth 2.1 + PKCE 进行身份验证。你的助手会打开浏览器,你只需登录一次,客户端便会缓存令牌。无需粘贴任何内容,也无需手动轮换密钥。

将整个 Unspam 工作流作为工具使用。

这些工具涵盖垃圾邮件检查、收件箱投递情况、自动化测试及其 SMTP 发件人、截图、热图、在 60 多种真实客户端和设备中的客户端预览、DMARC 报告、单个地址和邮件列表的电子邮件验证,以及账户状态。你的助手会读取工具目录,并根据每个请求选择合适的调用。

兼容团队已在使用的客户端。

Claude Desktop(自定义连接器或 mcp-remote 桥接程序)、Claude Code、Cursor、ChatGPT Developer Mode(Plus、Pro、Business)、Windsurf,以及任何支持远程 streamable-HTTP 服务器的 MCP 客户端。

一次连接,随时撤销。

此连接会显示在账户 API & MCP 页面中的 Connected apps 下,因此你可以单独撤销任何客户端的访问权限。MCP 包含在 Custom 套餐中,并使用套餐的每月限额。

后续提问也能接着聊。

你的助手会保留上下文,因此你可以继续询问同一项测试或域名,而不必从头开始。

查看价格

  • 我的每月额度还剩多少?

    读取你的套餐信息和剩余限额。

  • 显示我上次垃圾邮件检查的截图、热图和电子邮件客户端预览。

    调取同一项测试的这三项内容。

  • 立即触发我的新闻邮件自动化测试,并显示最近一次运行的结果。

    立即运行测试,然后读取运行结果。

  • 上周有哪些发件人使用 yourdomain.com 发送邮件?它们是否通过了 DMARC?

    读取汇总报告,并细化到每个来源。

连接的完整流程。

批准一个 OAuth 页面,将完整的 Unspam 工具集交给助手,然后用日常语言请求测试。

批准一个 OAuth 页面,无需复制密钥。

你的客户端会通过 Dynamic Client Registration 注册自身,然后使用带 PKCE (S256) 的 Authorization Code 授权流程。你通过浏览器登录,并在一个授权页面上批准对 mcp 的访问。

之后,客户端会缓存令牌并为你续期。令牌缺失或无效时会返回 401;令牌不包含 mcp 作用域,或套餐不支持 MCP 时会返回 403。

完整工具目录,供助手随时调用。

连接后,你的助手会看到下方列出的全部 {tools} 种工具。它们涵盖从 get_account_status 和 start_spam_check 到 configure_scheduled_test 和 get_email_list_results 的各种任务。

无需单独接入 SDK。客户端会通过 MCP 读取工具目录,并将每个工具直接提供给模型使用。

助手可以读取的错误信息。

工具无法完成任务时,会返回易于理解的消息,例如“未找到发件人”或“每月限额已用完”,助手可以据此向你解释,或尝试其他方法。

协议问题(例如工具未知或未登录)会以 JSON-RPC 错误的形式返回。

四步完成连接。

MCP 包含在 Custom 套餐中。将服务器 URL 添加到客户端,批准一次登录页面,然后用日常语言与助手交流。

  1. 01

    获取 Custom 套餐

    MCP 包含在 Custom 套餐中,月费最低为 $5。免费账户无法连接。连接后,get_account_status 会显示你的套餐信息和剩余限额。

  2. 02

    在客户端中添加服务器 URL

    Claude Code:claude mcp add --transport http unspam https://api.unspam.email/mcp。Cursor:将 {"url":"https://api.unspam.email/mcp"} 添加到 ~/.cursor/mcp.json。Claude Desktop 和 ChatGPT:将相同的 URL 粘贴为自定义连接器。

  3. 03

    批准 OAuth 授权页面

    客户端会打开浏览器,你登录 Unspam,然后批准对 mcp 的访问。令牌会被缓存,因此每个客户端只需操作一次。

  4. 04

    让助手运行测试

    试试“运行垃圾邮件检查,完成后告诉我。”助手会调用 start_spam_check,轮询 get_spam_check_result,然后在聊天中报告得分。

一台服务器。所有 Unspam 工具。

服务器列出了 7 组共 44 种工具。文档中包含每种工具的所有参数。

阅读文档

账户 1 种工具

  • get_account_status

垃圾邮件检查 8 种工具

  • start_spam_check
  • list_spam_checks
  • get_spam_check_result
  • get_spam_check_screenshots
  • get_spam_check_heatmap
  • create_client_preview
  • list_client_previews
  • list_client_preview_devices

收件箱投递情况 4 种工具

  • list_mailboxes
  • start_inbox_placement_test
  • list_inbox_placement_tests
  • get_inbox_placement_result

自动化测试:发件人 6 种工具

  • create_scheduled_test_sender
  • list_scheduled_test_senders
  • get_scheduled_test_sender
  • update_scheduled_test_sender
  • delete_scheduled_test_sender
  • test_scheduled_test_sender_connection

自动化测试:测试和运行 10 种工具

  • create_scheduled_test
  • set_scheduled_test_email
  • get_scheduled_test
  • list_scheduled_tests
  • configure_scheduled_test
  • set_scheduled_test_status
  • dispatch_scheduled_test
  • delete_scheduled_test
  • list_scheduled_test_runs
  • get_scheduled_test_run

DMARC 报告 10 种工具

  • create_dmarc_domain
  • list_dmarc_domains
  • get_dmarc_domain
  • get_dmarc_dns_instructions
  • verify_dmarc_domain
  • list_dmarc_reports
  • get_dmarc_report
  • get_dmarc_report_records
  • list_dmarc_ips
  • get_dmarc_ip

电子邮件验证 5 种工具

  • verify_email
  • get_email_verification
  • create_email_list
  • get_email_list
  • get_email_list_results

MCP 服务器常见问题。

支持的客户端、价格、身份验证、速率限制以及如何撤销访问权限。

支持哪些客户端?

任何支持远程 streamable-HTTP 服务器的 MCP 客户端都可以使用。其中包括 Claude Desktop(自定义连接器或 mcp-remote 桥接程序)、Claude Code、Cursor、ChatGPT Developer Mode(Plus、Pro、Business)和 Windsurf。所有客户端使用相同的服务器 URL:https://api.unspam.email/mcp。

免费吗?

不免费。MCP 包含在 Custom 套餐 中,月费最低为 $5;部分较早推出的付费套餐也已包含 MCP。免费账户无法连接。在助手中运行 get_account_status,即可查看套餐信息和每月剩余限额。

身份验证如何运作?

使用 OAuth 2.1、Dynamic Client Registration 和带 PKCE (S256) 的 Authorization Code 授权流程,作用域为 mcp。你只需通过浏览器登录一次,客户端便会缓存令牌。无需复制或手动轮换 API 密钥,并且可以随时撤销连接。

助手实际上能做什么?

共有七组工具:账户状态;垃圾邮件检查及其结果、截图、热图和客户端预览;收件箱投递情况;用于自动化测试的 SMTP 发件人;自动化测试及其运行历史记录;DMARC 报告;以及单个地址或最多包含 100,000 个地址的邮件列表验证。你可以用日常语言提问,例如“渲染这封营销邮件,并指出 Outlook 深色模式下的任何问题”,助手会串联调用合适的工具。

速率限制是多少?

每个账户每分钟最多可发出 100 次请求,超过后服务器会返回 429。此外,测试会使用套餐的每月限额,get_account_status 会显示该限额。限额用完时,工具会返回助手可以读取的消息。令牌缺失或无效时会返回 401;令牌不包含 mcp 作用域,或套餐不支持 MCP 时会返回 403。

如何撤销访问权限?

此连接会显示在 Unspam 账户 API & MCP 页面中的 Connected apps 下,你可以随时撤销访问权限。每种客户端的完整设置说明请参阅 MCP 服务器文档。

它能完成 REST API 的所有操作吗?

几乎可以。按 IP 查看 DMARC 明细,以及上传 CSV 或 TXT 格式的列表,仅支持通过 REST API 完成。通过 MCP 发送列表时,需将其作为地址数组传入。

代理能自行找到服务器吗?

是的。api.unspam.email 会发布 OAuth 发现文档、位于 /.well-known/mcp/server-card.json 的服务器卡片,以及列在 /.well-known/agent-skills/index.json 的智能体技能。

将你的 AI 助手连接到 Unspam。

MCP 包含在 Custom 套餐中,可在线购买,月费最低为 $5。

查看定价 API 概览