PostAgent

官方

打印并发送实体邮件和明信片至美国地址(USPS),每次调用通过Base链上的x402或信用卡以USDC按次付费。

你可以用 Post Agent MCP 做什么?

  • 上传文档进行打印 — 通过 upload 步骤将 PDF、HTML、Markdown、DOCX 或图像文件发送到 PostAgent。
  • 邮寄前获取报价 — 使用 quote 步骤验证发件人和收件人地址,并收到一个锁定 15 分钟有效的 USDC 价格。
  • 支付并发送实体邮件 — 确认报价以触发在 Base 上的 USDC 支付,并将文档发送到美国邮政地址。
  • 跟踪已邮寄的文档 — 轮询作业状态并检索先前提交的邮件的 USPS 跟踪信息。

文档

PostAgent — 打印与邮寄(Agent 技能)

一个可安装的 agent 技能,让你的 AI 编程助手能够 通过 PostAgent API,将文档(PDF、HTML、Markdown、文本、DOCX 或 图片)打印并实体邮寄美国邮政地址。每次发送均通过 x402 支付协议,使用 Base 主网上的 USDC 按次付费,然后由 PostAgent 的 打印与邮寄工作流处理。

邮寄邮件会花费真实资金,且一旦提交便不可撤销。该技能 始终会先提供报价,并要求用户在付款前明确确认。

安装

Claude Code(全局)— 请始终传递 -a claude-code,以便其安装到 ~/.claude/skills/,这是 Claude Code 唯一读取技能的位置:

npx skills add interpretai-tech/agent-tools --skill postagent-print-and-mail -g -a claude-code -y

然后重启 Claude Code — 技能列表仅在会话启动时读取一次,因此 新安装的技能在你重新启动之前不会出现。

其他 agent(自动检测 — 安装到每个 agent 各自的技能目录,例如 Codex/Cursor/Gemini 的 .agents/skills/):

npx skills add interpretai-tech/agent-tools --skill postagent-print-and-mail -y

如果不使用 -a claude-code,CLI 可能仅安装到通用的 .agents/skills/ 路径,而 Claude Code 不会读取该路径 — 技能将 显示为“已安装”,但永远不会加载。

-y 会跳过交互式的作用域/确认提示。如果你希望 在安装前确认作用域并进行审查,可以去掉它。

功能

  1. 上传文档(免费)— 已完成的信件或 {{field}} 邮件合并模板。
  2. 报价(免费)— 验证寄件人和收件人地址,并锁定一个包含所有费用的 USDC 价格,有效期为 15 分钟。
  3. 付款 — agent 的 x402 钱包支付报价的 paymentUrl;PostAgent 打印并邮寄信件。
  4. 追踪(免费)— 查询任务状态和 USPS 追踪信息。

可通过 REST API(纯 HTTP,无需设置)在任何 agent 中使用 — 也可在配置后 通过 PostAgent MCP 服务器https://api.postagent.sh/mcp)使用。 请参阅 SKILL.md 获取 agent 遵循的完整说明。

要求

  • 一个美国寄件人地址和一个美国收件人地址(2 字母州代码,5 位邮编/ZIP+4)。
  • 一个支持 x402 的钱包,并在 Base 主网上持有 USDC,用于按次付费。

许可证

MIT