@striderlabs/mcp-usps

MCP (Model Context Protocol) server for USPS package tracking, location finding, and shipping rate calculation using browser automation.

Features

• Track packages — Get real-time status, location history, and estimated delivery for any USPS tracking number
• Find locations — Locate nearby USPS post offices and collection boxes by ZIP code
• Calculate rates — Get shipping rates for packages between ZIP codes

Installation

npm install -g @striderlabs/mcp-usps

Or use directly via npx:

npx @striderlabs/mcp-usps

Prerequisites

Playwright Chromium browser must be installed:

npx playwright install chromium

MCP Configuration

Add to your Claude Desktop or MCP client config:

{
  "mcpServers": {
    "usps": {
      "command": "npx",
      "args": ["@striderlabs/mcp-usps"]
    }
  }
}

Tools

track_package

Track a USPS package by tracking number.

Parameters:

• tracking_number (string, required) — USPS tracking number (e.g. 9400111899223397556826)

Example:

Track package 9400111899223397556826

find_locations

Find USPS post offices and collection boxes near a ZIP code.

Parameters:

• zip (string, required) — 5-digit ZIP code
• type (string, optional) — post_office | collection_box | all (default: all)

Example:

Find post offices near 10001

calculate_rates

Calculate shipping rates between two ZIP codes.

Parameters:

• from_zip (string, required) — Origin 5-digit ZIP code
• to_zip (string, required) — Destination 5-digit ZIP code
• weight_oz (number, required) — Package weight in ounces
• length_in (number, optional) — Length in inches
• width_in (number, optional) — Width in inches
• height_in (number, optional) — Height in inches
• mail_class (string, optional) — Service type: priority_mail | priority_mail_express | first_class | ground_advantage | media_mail (default: priority_mail)

Example:

Calculate shipping rates from 10001 to 90210 for a 16oz package

How It Works

This server uses Playwright to automate Chromium and scrape data directly from USPS.com tools:

• Tracking: https://tools.usps.com/go/TrackConfirmAction
• Locations: https://tools.usps.com/find-location.htm
• Rates: https://postcalc.usps.com/

No USPS API key required.

License

MIT