Postage Stamp Price MCP

io.github.theluckystrike由 GitHub 账号 theluckystrike 发布v1.0.0更新于 Nov 5, 2026

How much is a stamp: USPS Forever stamp, postcard, international and letter postage by weight.

发布方自己的服务：PriceWin

已验证Streamable HTTP可网页运行位置与生活

服务详情

标识符: io.github.theluckystrike/postage-stamp-price-mcp
传输: Streamable HTTP
运行时: Web executable
信任: Verified
发布于: Nov 5, 2026

安全提示

MCP 服务会接收对话中的工具调用请求，并可能执行外部操作。启用前请先了解该服务能做什么，并只授予它所需的权限。

注册中心已验证此条目所属的 GitHub 账号 theluckystrike。这并不表明该账号就是产品方。

SourceWeft 的检查只涵盖条目是否完整、端点是否响应；不审查服务器的代码，也不审查其工具的行为。

在 README 中添加徽章

向读者展示该 MCP 服务已收录于 SourceWeft，徽章链接到本页。

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.theluckystrike%2Fpostage-stamp-price-mcp.svg)](https://sourceweft.com/mcp/io.github.theluckystrike%2Fpostage-stamp-price-mcp?utm_source=readme&utm_medium=badge)

概览

AI 生成的概览

远程 MCP 服务器，让助手在调用时从 USPS Notice 123 读取当前美国邮政零售邮资价格，并计算信件邮资。

可以做什么: 查询当前邮票价格：Forever 邮票、明信片、国际、计费表及按重量分档的信件价格，并附生效日期
按重量计算寄往美国、加拿大、墨西哥或其他国家的信件、明信片或大信封邮资，含非机读附加费、数量总价及每件所需 Forever 邮票数
查询 Priority Mail 与 Priority Mail Express 统一费率信封和箱子的价格
每次返回结构化 JSON，含摘要、数据日期与来源
适用场景: 当用户询问邮票多少钱、某次寄件需要多少邮资，或统一费率箱子价格时适用，可避免使用模型记忆中可能已过期的价格。
运行要求: 远程 streamable HTTP 端点，无需 API 密钥、令牌或注册。托管服务器在调用时抓取 USPS 价目表，并最多缓存 6 小时。文中提到的本地 npm 包尚未发布。

安装前请注意

仅做只读价格查询，不涉及账户、付款或个人数据。价格仅为 USPS 零售价，商业价、计费表价和 Click-N-Ship 价可能更低；除统一费率外不涵盖包裹，也不涵盖国际大信封。缓存价格可能滞后最多 6 小时。

安装

在 SourceWeft 中

打开控制台中的 Postage Stamp Price MCP，将其添加到工作区。
为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.theluckystrike%2Fpostage-stamp-price-mcp/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "postage-stamp-price": {
      "type": "http",
      "url": "https://postage-stamp-price-mcp.lipmichal.workers.dev/mcp"
    }
  }
}

README

postage-stamp-price-mcp

How much is a stamp, for AI assistants. Ask what a Forever stamp costs, what it takes to mail 40 square holiday cards, or what a letter to Germany costs, and get the current USPS price with its effective date.

This is a Model Context Protocol (MCP) server. It reads USPS Notice 123, the official retail price list on Postal Explorer, at call time. Prices are matched by the USPS SKU on each price cell. It needs no API key.

Tools

Tool	What it returns
`get_stamp_price`	The current Forever stamp price (1 oz First-Class Mail letter), 2, 3 and 3.5 oz prices, metered prices, postcard, 1 oz large envelope, nonmachinable surcharge and the 1 oz international letter (Global Forever) price, with the effective date.
`calculate_letter_postage`	Postage for a letter, postcard or large envelope by weight, to the US, Canada, Mexico or another country, with the nonmachinable surcharge, a total for a quantity and the number of Forever stamps per piece.
`get_flat_rate_prices`	Retail Priority Mail and Priority Mail Express flat rate envelope and box prices.

Every result has structured JSON, a one-paragraph summary, as_of, source and more (a page on mcpstamp.com).

What it knows that your model does not

The price in force today. USPS changes prices once or twice a year, so a remembered stamp price is often wrong.
The effective date of the price list, so the answer can say when the price started.
Surcharges and weight steps, so "two stamps or one?" has an exact answer.

Install

Hosted (Claude.ai custom connector, ChatGPT developer mode)

Paste this URL. No token, no sign-up. It works now.

Claude Code

claude mcp add --transport http stamp-price https://postage-stamp-price-mcp.lipmichal.workers.dev/mcp

claude mcp add --transport http stamp-price https://postage-stamp-price-mcp.lipmichal.workers.dev/mcp

Claude Desktop

Claude Desktop adds remote servers under Settings, Connectors, Add custom connector. Paste the URL above.

Cursor

Add to ~/.cursor/mcp.json:

json

{  "mcpServers": {    "stamp-price": { "url": "https://postage-stamp-price-mcp.lipmichal.workers.dev/mcp" }  }}

{  "mcpServers": {    "stamp-price": { "url": "https://postage-stamp-price-mcp.lipmichal.workers.dev/mcp" }  }}

VS Code

Add to .vscode/mcp.json:

json

{  "servers": {    "stamp-price": { "type": "http", "url": "https://postage-stamp-price-mcp.lipmichal.workers.dev/mcp" }  }}

{  "servers": {    "stamp-price": { "type": "http", "url": "https://postage-stamp-price-mcp.lipmichal.workers.dev/mcp" }  }}

Local stdio (after npm release)

The npm package is not published yet. After it is, run it locally with Node 20 or newer:

Example prompts

"How much is a stamp right now?"
"How much postage do I need for 40 square Christmas cards that weigh 1.2 oz?"
"How much does it cost to mail a letter to Germany?"
"How much is a medium flat rate box?"
"How much is a postcard stamp?"

Data sources

Full list with fetch dates in DATA_SOURCES.md.

USPS Notice 123 Price List, read at call time.

Limitations

Retail prices at the Post Office. Commercial, metered and Click-N-Ship prices can be lower; metered letter prices are included.
Packages (Ground Advantage, Priority Mail by zone) are not covered beyond flat rate. Use https://postcalc.usps.com/ for those.
International large envelopes are not covered yet.
The hosted server caches the price list for up to 6 hours.

More MCP servers that answer questions your assistant cannot answer alone are on mcpstamp.com.

Part of the Zovo MCP collection: https://mcp.zovo.one

Built by theluckystrike.

Development

npm installnpm test                              # builds, then runs the fixture tests and an offline stdio testnode scripts/stdio-transcript.mjs     # live stdio round trip, writes .live/stdio-transcript.jsonl

npm installnpm test                              # builds, then runs the fixture tests and an offline stdio testnode scripts/stdio-transcript.mjs     # live stdio round trip, writes .live/stdio-transcript.jsonl

License

MIT

来源：README.md，提交 6bed223

工具

get_stamp_price

Get stamp price

The current USPS Forever stamp price (First-Class Mail 1 oz stamped letter), the 2, 3 and 3.5 oz prices, metered letter prices, postcard, 1 oz large envelope, the nonmachinable surcharge and the 1 oz international letter (Global Forever) price, read at call time from USPS Notice 123 with its effective date.

无需输入参数。

calculate_letter_postage

Calculate letter postage

Retail postage for one letter, postcard or large envelope (flat) by weight, to the US, Canada, Mexico or any other country, with the nonmachinable surcharge for square or rigid cards, the total for a quantity, and the number of Forever stamps per piece. Letters up to 3.5 oz, US large envelopes up to 13 oz.

输入参数typequantityweight_ozdestinationnonmachinable

get_flat_rate_prices

Get flat rate box prices

Current USPS retail prices for Priority Mail Flat Rate envelopes and Small, Medium, Large and APO/FPO/DPO Flat Rate Boxes, and Priority Mail Express Flat Rate envelopes, from Notice 123.

无需输入参数。