USPS MCP server for AI agents
Let Claude, ChatGPT or your own agent read USPS: 2 typed functions through one MCP server. No USPS API key needed.
- Site
- usps.com
- Functions
- 2
- Sign-in
- Not needed
- Works with
- MCP, HTTP, Node, Python
Connect
Just USPS
An MCP server for USPS alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.
https://api.bowmark.ai/mcp/site/uspsEvery site
One MCP server for USPS and every other site Bowmark covers. Your agent looks up what it needs and calls it.
https://api.bowmark.ai/mcpSet it up in your clientBoth need a Bowmark API key. The quickstart gets you one and a first result in a few minutes.
Functions
Open a function to see its arguments, what it returns and how to call it.
Read 2
getRatePrices a domestic package across USPS's own Mail Services (Priority Mail Express, Priority Mail, the flat-rate boxes, Ground Advantage, Media Mail)…Arguments
Name Type Required args{ fromZip: string; toZip: string; weightOz: number; length?: number; width?: number; height?: number }Yes Returns
uspsRateOption[]interface uspsRateOption { postageServiceId: number; description: string; price: number; commercialPrice: number | null; deliveryDay: string | null; flatRateBox: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/usps/getRateCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.usps.getRate({ fromZip: "20024", toZip: "10001", weightOz: 16 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.usps.getRate({"fromZip": "20024", "toZip": "10001", "weightOz": 16}))curl -X POST https://api.bowmark.ai/v1/sites/usps/getRate \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"fromZip":"20024","toZip":"10001","weightOz":16}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.usps.getRate({ fromZip: "20024", toZip: "10001", weightOz: 16 });trackPackageUSPS Tracking for one tracking number: the item's steps newest first and whether it was delivered, "not found" when USPS says tracking is not…Arguments
Name Type Required trackingNumberstring10-35 letters and digits; spaces and dashes are ignored.Yes Returns
uspsTrackinginterface uspsTrackingEvent { status: string; // the site's own labels, read the values off a result, never guess one from prose detail: string | null; location: string | null; // as printed, e.g. "BROOKLYN, NY 11201" date: string | null; // as printed, e.g. "October 28, 2026, 1:16 pm" } interface uspsTracking { trackingNumber: string; status: "tracked" | "not_found" | "ambiguous"; delivered: boolean | null; // null unless status is "tracked" headline: string | null; // the page's banner heading message: string | null; // the page's banner sentence needs: ("sendDate" | "toZip")[]; // what USPS asks for to resolve an "ambiguous" number events: uspsTrackingEvent[]; // newest first; empty unless "tracked" source: "callerBrowser"; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/usps/trackPackageCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.usps.trackPackage({ trackingNumber: "9400100000000000000000" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.usps.trackPackage({"trackingNumber": "9400100000000000000000"}))curl -X POST https://api.bowmark.ai/v1/sites/usps/trackPackage \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"trackingNumber":"9400100000000000000000"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.usps.trackPackage({ trackingNumber: "9400100000000000000000" });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/usps/<function> - OpenAPI
/v1/sites/usps/openapi.json