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 报告 自动化测试
在聊天中为电子邮件评分
助手会启动检查,并告诉你要发送到哪个地址。结果出来后,它会逐项解释评分信号,还可以调取截图以及注意力和焦点热图。
对话示例
运行垃圾邮件检查,完成后告诉我。
start_spam_checkget_spam_check_resultget_spam_check_screenshotsget_spam_check_heatmap
完成。得分为 85 分(满分 100),SPF、DKIM 和 DMARC 均通过。
查看邮件被各邮箱放到了哪里
你只需向它返回的种子地址发送一封电子邮件,并在主题或正文中加入测试 ID。随后,它会报告每个邮箱中的邮件文件夹:收件箱、其他标签页、垃圾邮件或未收到。
对话示例
在我的所有邮箱中启动收件箱投递测试,并总结邮件的投递位置。
list_mailboxesstart_inbox_placement_testget_inbox_placement_result
你的邮件已送达 Gmail 和 Yahoo 的收件箱,但被 Outlook 放进了垃圾邮件。
在真实邮件客户端中渲染电子邮件
你可以使用已完成测试中的邮件、粘贴的 HTML,或发送给你的邮件进行渲染;可以覆盖套餐包含的所有设备,也可以只选择指定设备。
对话示例
渲染这封营销邮件,并指出 Outlook 深色模式下的任何问题。
list_client_preview_devicescreate_client_previewlist_client_previews
Outlook 深色模式的渲染结果显示,白色文字出现在白色页眉上。其他设备上的显示正常。
发送前清理邮件列表
验证单个地址或最多包含 100,000 个地址的列表。每条结果都包含状态、原因、建议操作以及可能的拼写建议。只有明确的结果才会消耗额度。
对这 300 个地址进行检查,并告诉我哪些应该移除。
create_email_listget_email_listget_email_list_results
有 22 个地址无法投递,请移除这些地址。另有 5 个地址存在风险,建议审核。
查明哪些发件人使用你的域名发送邮件
注册域名,获取要发布的 TXT 记录,并通过实时 DNS 检查进行验证。之后,你可以询问哪些发件人使用你的域名发送邮件,助手会读取汇总报告,细化到每个来源 IP。
为 yourdomain.com 设置 DMARC 监控,并告诉我需要发布什么 DNS 记录。
create_dmarc_domainget_dmarc_dns_instructionsverify_dmarc_domain
请在 _dmarc.yourdomain.com 上发布此 TXT 记录。记录生效后告诉我,我会进行验证。
按计划定期运行测试
它会连接并测试你的 SMTP 发件人,根据你的内容构建邮件或捕获你发送的邮件,然后设置计划、邮箱、启用的检查项和提醒规则。它还可以立即运行测试并读取运行历史记录。
使用我的 SMTP 发件人设置每周自动测试,如果有任何邮件进入垃圾邮件文件夹,就发邮件通知我。
create_scheduled_test_sendertest_scheduled_test_sender_connectioncreate_scheduled_testconfigure_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 添加到客户端,批准一次登录页面,然后用日常语言与助手交流。
-
01
获取 Custom 套餐
MCP 包含在 Custom 套餐中,月费最低为 $5。免费账户无法连接。连接后,
get_account_status会显示你的套餐信息和剩余限额。 -
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 粘贴为自定义连接器。 -
03
批准 OAuth 授权页面
客户端会打开浏览器,你登录 Unspam,然后批准对
mcp的访问。令牌会被缓存,因此每个客户端只需操作一次。 -
04
让助手运行测试
试试“运行垃圾邮件检查,完成后告诉我。”助手会调用
start_spam_check,轮询get_spam_check_result,然后在聊天中报告得分。
一台服务器。所有 Unspam 工具。
服务器列出了 7 组共 44 种工具。文档中包含每种工具的所有参数。
账户 1 种工具
get_account_status
垃圾邮件检查 8 种工具
start_spam_checklist_spam_checksget_spam_check_resultget_spam_check_screenshotsget_spam_check_heatmapcreate_client_previewlist_client_previewslist_client_preview_devices
收件箱投递情况 4 种工具
list_mailboxesstart_inbox_placement_testlist_inbox_placement_testsget_inbox_placement_result
自动化测试:发件人 6 种工具
create_scheduled_test_senderlist_scheduled_test_sendersget_scheduled_test_senderupdate_scheduled_test_senderdelete_scheduled_test_sendertest_scheduled_test_sender_connection
自动化测试:测试和运行 10 种工具
create_scheduled_testset_scheduled_test_emailget_scheduled_testlist_scheduled_testsconfigure_scheduled_testset_scheduled_test_statusdispatch_scheduled_testdelete_scheduled_testlist_scheduled_test_runsget_scheduled_test_run
DMARC 报告 10 种工具
create_dmarc_domainlist_dmarc_domainsget_dmarc_domainget_dmarc_dns_instructionsverify_dmarc_domainlist_dmarc_reportsget_dmarc_reportget_dmarc_report_recordslist_dmarc_ipsget_dmarc_ip
电子邮件验证 5 种工具
verify_emailget_email_verificationcreate_email_listget_email_listget_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。