Unspam MCP

官方

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

你可以用 Unspam MCP 做什么?

  • Check account limits — Ask the assistant to call get_account_status to see your subscription tier and remaining monthly quota before running tests.
  • Run a spam check — Have the assistant start a check with start_spam_check, then poll get_spam_check_result for the score and placement details.
  • View spam check visuals — Retrieve screenshots and heatmaps for a completed check using get_spam_check_screenshots and get_spam_check_heatmap.
  • Test inbox placement — List available mailboxes with list_mailboxes, then run a seed-list test via start_inbox_placement_test and review per-folder results.
  • Schedule recurring autopilot tests — Create a scheduled test with create_scheduled_test, toggle its status, and inspect past runs through list_scheduled_test_runs.

文档

Unspam MCP 服务器

让您的 AI 助手以安全、通俗的语言访问 Unspam:垃圾邮件检查、收件箱放置、截图、热力图以及定期自动测试。通过 OAuth 连接,无需复制 API 密钥。

// Claude Code:添加服务器

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

# sign in through the browser once.
# OAuth 2.1 + PKCE, no keys to copy.
# the client caches your token.

// Cursor:~/.cursor/mcp.json

{
  "mcpServers": {
    "unspam": {
      "url": "https://api.unspam.email/mcp"
    }
  }
}

# Claude Desktop and ChatGPT: paste the
# same URL as a custom connector.

账户状态

在开始运行之前,读取订阅信息和剩余月度限额。

  • get_account_status

垃圾邮件检查

启动检查、列出历史检查,并获取评分、截图和热力图。

  • start_spam_check
  • get_spam_check_result
  • get_spam_check_screenshots
  • get_spam_check_heatmap

收件箱放置

跨邮箱运行种子列表放置测试,并读取各文件夹的结果。

  • list_mailboxes
  • start_inbox_placement_test
  • get_inbox_placement_result

自动测试

安排定期测试,管理您发送邮件所用的多个 SMTP 发件人,并查看每次运行记录。

  • create_scheduled_test
  • set_scheduled_test_status
  • list_scheduled_test_runs

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

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

以工具形式呈现的完整 Unspam 工作流。

约 30 个工具涵盖垃圾邮件检查、收件箱放置、自动测试(定时测试)、截图和热力图,以及账户状态。您的助手会读取目录,并为每个请求选择合适的调用。

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

Claude Desktop(自定义连接器或 mcp-remote 桥接)、Claude Code、Cursor、ChatGPT 开发者模式(Plus、Pro、Business)、Windsurf,以及任何支持远程可流式 HTTP 服务器的 MCP 客户端。

一次连接,随时撤销。

该连接会显示在您 Unspam 账户的“已连接应用”下,您可以随时撤销。MCP 访问仅适用于付费计划,并受您的订阅配额限制。

01

批准一次 OAuth 屏幕,无需复制密钥。

您的客户端通过动态客户端注册自行注册,然后运行带有 PKCE(S256)的授权码授予流程。您通过浏览器登录,并批准一个范围限定为 mcp 的单一同意屏幕。

之后,客户端会缓存令牌并为您续期。令牌缺失或无效会返回 401,范围错误会返回 403,因此故障模式是明确的。

api.unspam.email

连接 Unspam

允许您的助手在您的账户上运行电子邮件测试。

  • 运行并读取垃圾邮件检查
  • 运行收件箱放置测试
  • 管理定时自动测试

取消 授权

OAuth 2.1 · PKCE · 范围:mcp

02

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

连接后,您的助手可以看到所有 Unspam 工具:start_spam_checkget_spam_check_resultget_spam_check_screenshotsget_spam_check_heatmap、收件箱放置工具集、定时测试(自动测试)工具集,以及用于查看限制的 get_account_status

无需连接单独的 SDK。客户端通过 MCP 读取目录,并将每个工具直接暴露给模型。

  • get_account_status 账户
  • start_spam_check 垃圾邮件
  • get_spam_check_result 垃圾邮件
  • start_inbox_placement_test 收件箱
  • create_scheduled_test 自动测试
  • list_scheduled_test_runs 自动测试

03

用通俗语言提问,助手会串联调用。

说“运行一次垃圾邮件检查,完成后告诉我”或“在所有邮箱中启动收件箱放置测试”,助手便会依次调用工具、轮询结果并报告。

以同样的方式设置定期覆盖:“安排每周自动测试,如果有任何邮件进入垃圾箱,请发邮件通知我。”自动测试工具会为您创建发件人、时间表和通知。

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

正在处理。串联工具:start_spam_check get_spam_check_result 完成。评分 85/100,收件箱放置情况良好。

  1. 01

选择付费计划

MCP 需要 API 访问权限,所有付费计划均包含此权限。免费账户无法连接。随时使用 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,并在聊天中报告评分。

关于 MCP 服务器的常见问题。

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

支持哪些客户端? +

任何支持远程可流式 HTTP 服务器的 MCP 客户端。包括 Claude Desktop(自定义连接器或 mcp-remote 桥接)、Claude Code、Cursor、开发者模式下的 ChatGPT(Plus、Pro、Business)以及 Windsurf。设置始终使用相同的服务器 URL:https://api.unspam.email/mcp

它是免费的吗? +

不。MCP 访问仅适用于付费计划,并包含在 API 使用中。免费账户无法连接。从您的助手运行 get_account_status 以查看您的订阅和剩余月度限额。

身份验证如何工作? +

OAuth 2.1,结合动态客户端注册和带有 PKCE(S256)的授权码授予,范围限定为 mcp。您只需通过浏览器登录一次,客户端便会缓存令牌。无需复制或手动轮换 API 密钥,您可以随时撤销连接。

助手实际上能做什么? +

约 30 个工具,涵盖四个领域:账户状态、垃圾邮件检查(启动、列表、结果、截图、热力图)、收件箱放置(邮箱、测试、结果)以及自动测试(定时测试、SMTP 发件人和运行历史)。用通俗语言提问,例如“设置每周自动测试,如果有任何邮件进入垃圾箱,请发邮件通知我”,助手便会串联正确的调用。

速率限制是什么? +

使用量按账户受您的订阅配额限制。随时使用 get_account_status 检查。如果超出限制,服务器会返回 429。令牌缺失或无效会返回 401,范围错误会返回 403

如何撤销访问权限? +

该连接会显示在您 Unspam 账户的 已连接应用 下,您可以随时在此处撤销。每个客户端的完整设置详情请参阅 MCP 服务器文档。

将您的 AI 助手连接到 Unspam。

MCP 访问包含在所有付费计划中。

查看定价 →