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.

無需輸入參數。