mcpField
P
PostAgent

PostAgent

远程服务
api.postagent.sh通信协作118 周前更新

关于 PostAgent

PostAgent 是用于通过打印邮寄 API 向美国地址寄送文档的 Agent 技能,支持多种文档格式。寄送不可撤销且需付费;它会先提供报价,并要求明确确认后才付款寄出。

主要功能

  1. 01寄送 PDF、HTML、Markdown、文本、DOCX 和图片
  2. 02上传文档或邮件合并模板
  3. 03获取地址与邮费报价
  4. 04使用 Base 上的 USDC 按次付款
  5. 05跟踪任务状态和 USPS 投递

适用场景

  1. 01向美国地址寄送已完成的信件
  2. 02发送邮件合并文档
  3. 03付款前核对邮寄报价
  4. 04查看邮寄任务及 USPS 跟踪信息

MCP 相关

该技能通过 PostAgent REST API 工作;完成配置后,也可选用 `https://api.postagent.sh/mcp` 上的 PostAgent MCP 服务。

配置

远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。

服务地址https://api.postagent.sh/mcp
一键复制安装命令
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

工具

14
参数类型必填说明
installedMcpVersionstring否已连接的 PostAgent MCP 服务所声明的版本(如果已知)。
installedSkillVersionstring否已安装的 PostAgent SKILL.md frontmatter 中的版本(如果已知)。

详细介绍

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

一个可安装的Agent 技能,让你的 AI 编码 Agent 可以通过 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(自动检测——安装到各自的技能目录,例如 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. 获取报价(免费)——验证发件人和收件人地址,并锁定 15 分钟有效的 USDC 含税价格。
  3. 付款——Agent 的 x402 钱包支付报价中的 paymentUrl;PostAgent 随后打印并邮寄信件。
  4. 追踪(免费)——查询作业状态和 USPS 追踪信息。

任何 Agent 都可通过REST API 使用(纯 HTTP,无需设置)——也可以在配置完成后通过 PostAgent MCP 服务(https://api.postagent.sh/mcp)使用。完整操作说明请参阅 SKILL.md。

要求

  • 美国发件人和美国收件人地址(两位州代码、5 位邮政编码或 ZIP+4)。
  • 支持 x402 的钱包,且钱包需在 Base 主网上持有 USDC,以支付每次发送的费用。

许可证

MIT

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。