关于 PostAgent
PostAgent 是用于通过打印邮寄 API 向美国地址寄送文档的 Agent 技能,支持多种文档格式。寄送不可撤销且需付费;它会先提供报价,并要求明确确认后才付款寄出。
主要功能
- 01寄送 PDF、HTML、Markdown、文本、DOCX 和图片
- 02上传文档或邮件合并模板
- 03获取地址与邮费报价
- 04使用 Base 上的 USDC 按次付款
- 05跟踪任务状态和 USPS 投递
适用场景
- 01向美国地址寄送已完成的信件
- 02发送邮件合并文档
- 03付款前核对邮寄报价
- 04查看邮寄任务及 USPS 跟踪信息
MCP 相关
该技能通过 PostAgent REST API 工作;完成配置后,也可选用 `https://api.postagent.sh/mcp` 上的 PostAgent MCP 服务。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://api.postagent.sh/mcpclaude mcp add --transport http tech-interpretai-postagent https://api.postagent.sh/mcp{"mcpServers":{"tech-interpretai-postagent":{"type":"http","url":"https://api.postagent.sh/mcp"}}}在 Cursor 中打开{"servers":{"tech-interpretai-postagent":{"type":"http","url":"https://api.postagent.sh/mcp"}}}在 VS Code 中打开{"mcpServers":{"tech-interpretai-postagent":{"type":"http","url":"https://api.postagent.sh/mcp"}}}{"mcpServers":{"tech-interpretai-postagent":{"serverUrl":"https://api.postagent.sh/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
14| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| installedMcpVersion | string | 否 | 已连接的 PostAgent MCP 服务所声明的版本(如果已知)。 |
| installedSkillVersion | string | 否 | 已安装的 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会跳过交互式的范围/确认提示。如果你想确认范围并在安装前检查,请去掉它。
功能
- 上传文档(免费)——已完成的信件或
{{field}}邮件合并模板。 - 获取报价(免费)——验证发件人和收件人地址,并锁定 15 分钟有效的 USDC 含税价格。
- 付款——Agent 的 x402 钱包支付报价中的
paymentUrl;PostAgent 随后打印并邮寄信件。 - 追踪(免费)——查询作业状态和 USPS 追踪信息。
任何 Agent 都可通过REST API 使用(纯 HTTP,无需设置)——也可以在配置完成后通过 PostAgent MCP 服务(https://api.postagent.sh/mcp)使用。完整操作说明请参阅 SKILL.md。
要求
- 美国发件人和美国收件人地址(两位州代码、5 位邮政编码或 ZIP+4)。
- 支持 x402 的钱包,且钱包需在 Base 主网上持有 USDC,以支付每次发送的费用。
许可证
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。