明信片发送服务

@明信片机器人/mcp服务器

通过代码发送真正的明信片。 MCP服务器 明信片.bot --让AI代理在全球范围内发送实体明信片。

适用于Claude Desktop、Claude Code、Cursor、Windsurf和任何兼容MCP的客户端。

托管服务器（推荐）

最简单的入门方法-无需API密钥，无需本地安装。只需添加网址并使用您的Postcard.bot帐户登录：

https://postcard.bot/api/mcp

克劳德桌面 (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "postcardbot": {
      "url": "https://postcard.bot/api/mcp"
    }
  }
}

克劳德代码：

claude mcp add --transport http postcardbot https://postcard.bot/api/mcp

您的MCP客户端将打开一个浏览器，让您使用谷歌或电子邮件登录。点击“允许”，您就可以发送明信片了。

本地服务器（npm）

如果您更喜欢使用API密钥在本地运行服务器：

1.获取API密钥

注册地址： 明信片.bot，去你的 帐户页面，并生成API密钥。

2.添加余额

在以下位置添加学分 明信片.折扣/购买信用 或者通过API。预付余额——批量定价从0.69美元/明信片起。

3.配置您的MCP客户端

克劳德桌面 (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "postcardbot": {
      "command": "npx",
      "args": ["-y", "@postcardbot/mcp-server"],
      "env": {
        "POSTCARDBOT_API_KEY": "pk_live_your_key_here"
      }
    }
  }
}

克劳德代码：

claude mcp add postcardbot -- npx -y @postcardbot/mcp-server

然后设置环境变量 POSTCARDBOT_API_KEY 在你的壳里。

光标/风帆 --将相同的JSON配置添加到MCP设置中。

工具

send_postcard

发送一张实体明信片。卡片在24小时内打印并发货。交货需要5-10个工作日。

参数：

• to --收件人地址(name, address_line1, city 必修的； address_line2, state, zip, country 可选）
• from --发件人/回邮地址（相同字段）
• message --卡片背面信息（最多350个字符）
• image_url --正面图片URL（可公开访问，建议最小1875x1275px）

示例提示：

“给加利福尼亚州旧金山主街123号94102的Jane Doe寄一张明信片，上面有金门大桥的照片和信息‘希望你在这里！’”

bulk_send

将同一张明信片发送给多个收件人（异步）。每个请求最多5000个收件人。卡片在后台批量处理。

参数：

• recipients --收件人地址数组（最多5000个，字段与 to 以上）
• from --发件人/回邮地址（所有明信片相同）
• message --卡片背面信息（最多350个字符）
• image_url --正面图片URL（可公开访问，建议最小1875x1275px）

返回a bulk_id 立即。卡片在后台处理（~25/分钟）。使用 check_status 轮询进度。

总成本已预先预留。失败的卡将自动退款。

check_balance

检查账户余额、终身充值金额和当前批量定价级别。

get_pricing

获取所有批量定价级别。

check_status

检查以前发送的明信片的投递状态。

参数：

• postcard_id --返回的ID send_postcard

list_webhooks

列出您帐户的所有已注册Webhook。

create_webhook

注册一个URL以接收明信片事件通知（发送、传递、失败、返回）。URL必须使用HTTPS。每个帐户最多10个webhooks。

参数：

• url --用于接收webhook POST请求的HTTPS URL
• events --事件类型： postcard.created, postcard.sent, postcard.delivered, postcard.failed, postcard.returned

签名密钥只返回一次，请安全保存。事件使用HMAC-SHA256在 X-PostcardBot-Signature 头球

delete_webhook

按ID删除已注册的webhook。

参数：

• webhook_id --webhook ID（wh_…）

REST API

您也可以在不使用MCP的情况下直接使用HTTP API：

curl -X POST https://postcard.bot/api/v1/postcards \
  -H "Authorization: Bearer pk_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "to": {"name": "Jane Doe", "address_line1": "123 Main St", "city": "San Francisco", "state": "CA", "zip": "94102"},
    "from": {"name": "John Smith", "address_line1": "456 Oak Ave", "city": "New York", "state": "NY", "zip": "10001"},
    "message": "Wish you were here!",
    "image_url": "https://example.com/photo.jpg"
  }'

API完整文档和OpenAPI规范： postcard.bot/开发者

环境变量

定价

批量定价（基于终身充值金额）：

链接

• 明信片.bot
• 开发人员文档
• OpenAPI规范
• 购买积分
• npm包

许可证

麻省理工学院