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.

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/usps
Every 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/mcp
Set it up in your client

Both 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

    NameTypeRequired
    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/getRate

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    trackingNumberstring
    10-35 letters and digits; spaces and dashes are ignored.
    Yes

    Returns uspsTracking

    interface 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/trackPackage

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.usps.trackPackage({ trackingNumber: "9400100000000000000000" });

Use it from code