Postgrid MCP Server

PostGrid MCP服务器

用于PostGrid打印、邮件和地址验证API的MCP服务器。发送信件（标准、认证、带回执认证），邮寄MICR编码支票，管理联系人和模板，验证美国/加拿大地址——所有这些都来自克劳德。

工具（30）

联系人

• postgrid_create_contact --创建邮件联系人
• postgrid_get_contact --获取联系方式
• postgrid_list_contacts --使用搜索和分页功能列出联系人
• postgrid_update_contact --更新联系人字段
• postgrid_delete_contact --删除联系人

地址验证

• postgrid_verify_address --验证和标准化地址（结构化或自由形式）
• postgrid_verify_addresses_batch --一次最多验证2000个地址
• postgrid_autocomplete_address --自动完成部分地址
• postgrid_lookup_city_state --从邮政编码查找城市/州

信件

• postgrid_create_letter --发送信件（头等舱、标准、认证或带回执的认证）
• postgrid_get_letter --获取信件状态和跟踪
• postgrid_list_letters --列出带有搜索和分页功能的字母
• postgrid_cancel_letter --打印前取消信件

银行账户

• postgrid_create_bank_account --为支票付款注册银行账户
• postgrid_get_bank_account --获取银行账户详细信息（数字被屏蔽）
• postgrid_list_bank_accounts --列出银行账户
• postgrid_delete_bank_account --删除银行账户

检查

• postgrid_create_cheque --发送MICR编码支票
• postgrid_get_cheque --获取检查状态
• postgrid_list_cheques --带分页的列表检查
• postgrid_cancel_cheque --打印前取消检查

模板

• postgrid_create_template --使用Handlebars合并变量创建HTML模板
• postgrid_get_template --获取模板详细信息和HTML内容
• postgrid_list_templates --列出模板
• postgrid_update_template --更新模板HTML或描述
• postgrid_delete_template --删除模板

效用

• postgrid_upload_pdf --将PDF上传到临时存储（Cloudflare R2）并获取PostGrid的URL
• postgrid_get_upload_url --获取一个预签名的PUT/Get URL对，用于直接上传到R2的PDF（适用于协作/沙盒环境）
• postgrid_estimate_cost -在没有API调用的情况下估计邮寄成本
• postgrid_account_summary -显示API模式、连接和费率表

设置

1.获取API密钥

注册地址： postgrid.com 并从仪表板获取您的API密钥：

• 打印和邮寄API密钥 --用于联系人、信件、支票、模板
• 地址验证API密钥 --用于地址验证工具

支持测试密钥和实时密钥。测试密钥以开头 test_ 实时密钥以开头 live_.

2.安装

git clone https://github.com/nathanieljones/postgrid-mcp-server.git
cd postgrid-mcp-server
npm install

3.配置

创建一个 .env 文件（或设置环境变量）：

POSTGRID_PRINT_API_KEY=test_sk_...
POSTGRID_VERIFY_API_KEY=test_sk_...

对于实时密钥，您还必须设置：

POSTGRID_CONFIRM_LIVE_MODE=true

这可以防止意外发送真实邮资。

PDF上传（可选） --使用 postgrid_upload_pdf，配置Cloudflare R2：

R2_ACCESS_KEY_ID=your_r2_access_key
R2_SECRET_ACCESS_KEY=your_r2_secret_key
R2_ENDPOINT=https://.r2.cloudflarestorage.com
R2_BUCKET=postgrid-pdfs

在Cloudflare仪表板中创建一个R2 bucket，并添加生命周期规则，以便在1天后自动删除对象。

4.添加到克劳德

克劳德代码 (~/.claude.json):

{
  "mcpServers": {
    "postgrid": {
      "command": "node",
      "args": ["/full/path/to/postgrid-mcp-server/dist/index.js"],
      "env": {
        "POSTGRID_PRINT_API_KEY": "test_sk_...",
        "POSTGRID_VERIFY_API_KEY": "test_sk_...",
        "R2_ACCESS_KEY_ID": "your_r2_access_key",
        "R2_SECRET_ACCESS_KEY": "your_r2_secret_key",
        "R2_ENDPOINT": "https://.r2.cloudflarestorage.com",
        "R2_BUCKET": "postgrid-pdfs"
      }
    }
  }
}

克劳德桌面/协作 (claude_desktop_config.json):

{
  "mcpServers": {
    "postgrid": {
      "command": "node",
      "args": ["/full/path/to/postgrid-mcp-server/dist/index.js"],
      "env": {
        "POSTGRID_PRINT_API_KEY": "test_sk_...",
        "POSTGRID_VERIFY_API_KEY": "test_sk_...",
        "R2_ACCESS_KEY_ID": "your_r2_access_key",
        "R2_SECRET_ACCESS_KEY": "your_r2_secret_key",
        "R2_ENDPOINT": "https://.r2.cloudflarestorage.com",
        "R2_BUCKET": "postgrid-pdfs"
      }
    }
  }
}

安全特性

两步确认 — postgrid_create_letter 和 postgrid_create_cheque 需要两个电话。第一个返回成本预览；第二（with confirmed: true)实际上发送。

直播模式门 -实时API密钥需要 POSTGRID_CONFIRM_LIVE_MODE=true 在环境中。如果没有它，服务器将拒绝使用实时密钥启动。

模式指示器 --每个响应都以前缀 [TEST] 或 [LIVE] 所以你总是知道你处于哪种模式。

检查安全阈值 --超过10000美元的支票显示警告。超过100000美元的支票被拒绝。

帐号屏蔽 --银行账户和路由号码在所有响应中都被屏蔽。

幂等性 --创建操作包括唯一的幂等性密钥，因此网络重试不会产生重复。

费率表

使用 postgrid_estimate_cost 在发送之前计算成本。

许可证

麻省理工学院