Postage Stamp Price MCP

postage-stamp-price-mcp

AI アシスタント向けの切手料金情報です。Forever 切手の料金や、四角いホリデーカードを40枚送るのに必要な料金、ドイツ宛ての手紙の料金を尋ねると、現在の USPS 料金と適用開始日を確認できます。

これは Model Context Protocol（MCP）サーバーです。呼び出し時に、Postal Explorer に掲載されている公式小売料金表、USPS Notice 123 を読み込みます。料金は各価格セルに記載された USPS SKU に基づいて照合します。API キーは不要です。

ツール

ツール	返される情報
get_stamp_price	現在の Forever 切手料金（First-Class Mail の1オンスの手紙）、2、3、3.5オンスの料金、郵便料金計器を使用した場合の料金、はがき、1オンスの大型封筒、機械処理不可の追加料金、1オンスの国際郵便料金（Global Forever）、および適用開始日。
calculate_letter_postage	重量に応じた、米国、カナダ、メキシコ、またはその他の国宛ての手紙、はがき、大型封筒の郵便料金。機械処理不可の追加料金、複数個分の合計、1個あたりに必要な Forever 切手の枚数も含みます。
get_flat_rate_prices	Priority Mail および Priority Mail Express の定額料金の封筒と箱の小売価格。

すべての結果には、構造化 JSON、1段落の概要、as_of、source、およびmore（mcpstamp.com上のページ）が含まれます。

モデルが知らない情報

• 今日適用されている料金です。USPS は年に1、2回料金を改定するため、記憶されている切手料金は間違っていることがよくあります。
• 料金表の適用開始日です。これにより、料金がいつから適用されたかを回答できます。
• 追加料金と重量区分です。「切手は2枚、それとも1枚？」という質問にも正確に答えられます。

インストール

ホスト型（Claude.ai のカスタムコネクター、ChatGPT の開発者モード）

この URL を貼り付けてください。トークンも登録も不要です。すぐに利用できます。

https://postage-stamp-price-mcp.lipmichal.workers.dev/mcp

Claude Code

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

Claude Desktop

Claude Desktop では、Settings、Connectors、Add custom connector の順に進むと、リモートサーバーを追加できます。上記の URL を貼り付けてください。

Cursor

~/.cursor/mcp.jsonに追加します：

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

VS Code

.vscode/mcp.jsonに追加します：

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

ローカル stdio（npm リリース後）

npm パッケージはまだ公開されていません。公開後は、Node 20 以降でローカル実行できます：

claude mcp add stamp-price -- npx -y postage-stamp-price-mcp

プロンプトの例

• 「今の切手料金はいくらですか？」
• 「重さ1.2オンスの四角いクリスマスカードを40枚送るには、郵便料金はいくら必要ですか？」
• 「ドイツへ手紙を送るといくらかかりますか？」
• 「中型の定額料金箱はいくらですか？」
• 「はがき用切手はいくらですか？」

データソース

取得日を含む一覧はDATA_SOURCES.mdをご覧ください。

• USPS Notice 123 料金表。呼び出し時に読み込みます。

制限事項

• 郵便局での小売価格です。商業料金、郵便料金計器を使用した料金、Click-N-Ship の料金のほうが安い場合があります。郵便料金計器を使用した手紙の料金は含まれています。
• 小包（Ground Advantage、ゾーン別 Priority Mail）は、定額料金以外は対象外です。これらについては https://postcalc.usps.com/ をご利用ください。
• 国際郵便の大型封筒は、まだ対象外です。
• ホスト型サーバーでは、料金表が最大6時間キャッシュされます。

詳細

アシスタントだけでは答えられない質問に回答する、その他の MCP サーバーはmcpstamp.comでご覧いただけます。

Zovo MCP コレクションの一部です：https://mcp.zovo.one

theluckystrikeが開発しました。

開発

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

ライセンス

MIT