Postfleet

Postfleet MCP

为 AI Agent 配置专属邮箱地址。Postfleet 是面向 Agent 的邮件基础设施——收到的邮件会先经过解析、分类、提取到你的架构中，并进行提示词注入筛查，然后才会被 Agent 读取。

此仓库包含服务端源码及其插件清单。这是一个镜像仓库——代码在 Postfleet 应用仓库中开发，并发布到 npm，包名为 @postfleet/mcp；你可以在此提交问题和补丁，它们会被合并到上游。该服务有两种运行方式：

托管版（无需安装）	https://api.postfleet.ai/api/mcp，可流式传输的 HTTP，Authorization: Bearer pf_...
本地版（stdio）	通过 npx 运行 @postfleet/mcp

在 postfleet.ai 获取 pf_ API 密钥。

工具

list_mailboxes、create_mailbox、list_domains、create_domain、verify_domain、 send_email、reply_email、list_inbox、read_email、wait_for_email——以及用于邮件发送前由人工审批的流程的草稿生命周期工具（create_draft、list_drafts、get_draft、update_draft、send_draft、delete_draft）。发送操作若进入审批流程，会返回 202 pending_approval，这并不代表失败。

每个工具都是对 REST 的轻量封装——它会调用你的密钥已经可以访问的相同 /api/v1/ 端点（OpenAPI），因此身份验证、范围限制和配额只需统一执行一次。

安装

Cursor 市场插件

此仓库中的清单文件（mcp.json、.cursor-plugin/plugin.json）为托管服务声明了 headers.Authorization = Bearer ${POSTFLEET_API_KEY}，本地 npx @postfleet/mcp 也使用相同变量。安装插件时应该会提示输入密钥，并将其作为真正的 Bearer 标头附加——如果仅添加原始 URL 而未提供标头，在提供密钥或托管连接卡片完成 OAuth 之前，initialize 会返回 401。

Cursor（手动）

{
  "mcpServers": {
    "postfleet": {
      "url": "https://api.postfleet.ai/api/mcp",
      "headers": { "Authorization": "Bearer pf_your_key_here" }
    }
  }
}

本地 stdio（npx -y @postfleet/mcp）

npx -y @postfleet/mcp

任何支持 stdio 的 MCP 客户端都可以在设置 POSTFLEET_API_KEY 后运行该命令：

{
  "mcpServers": {
    "postfleet": {
      "command": "npx",
      "args": ["-y", "@postfleet/mcp"],
      "env": { "POSTFLEET_API_KEY": "pf_your_key_here" }
    }
  }
}

Claude Code

claude mcp add postfleet --env POSTFLEET_API_KEY=pf_your_key_here -- npx -y @postfleet/mcp

POSTFLEET_API_URL（默认为 https://api.postfleet.ai）可用于为暂存环境或可自托管部署覆盖 API 源地址。

密钥

密钥有范围限制——bootstrap 只能创建邮箱，api 可用于邮件操作，而 mcp 是应提供给客户端的密钥。为每种工作负载使用单独的密钥，这样撤销一个密钥时不会影响其他工作负载。切勿提交密钥；此仓库中的清单文件有意不包含任何密钥。

链接

• 注册目录条目：MCP 注册表（MCP Registry）中的 ai.postfleet/postfleet
• npm：@postfleet/mcp
• 文档：postfleet.ai/docs/mcp

从源码构建

npm install && npm run build   # tsup → dist/

采用 MIT 许可证。