Connector guide12-minute read32 MCP tools7 languages

Connect USPS to Meta Muse via MCP: Shipping Rates

USPS APIs for shippers: validate US addresses and look up ZIP Codes, compare domestic and international prices, get delivery days and shipping options, track packages, and find Post Offices, drop-off sites and Parcel Lockers. Labels, refunds, pickups and SCAN Forms are included but switched off. Consumer Key and Secret of an app in the USPS Customer Onboarding Portal.

HCBy HelpCode teamUpdated 12 min read Open-source on GitHub

No credit card · 7-day trial · Self-host alternative available

USPS

USPS

USPS APIs for shippers: validate US addresses and look up ZIP Codes, compare domestic and international prices, get delivery days and shipping options, track packages, and find Post Offices, drop-off sites and Parcel Lockers. Labels, refunds, pickups and SCAN Forms are included but switched off. Consumer Key and Secret of an app in the USPS Customer Onboarding Portal.

tools

32

Region

INTL

Category

Logistics

Authentication

OAuth 2.0

Required env vars

USPS_CLIENT_IDUSPS_CLIENT_SECRETUSPS_API_HOST
Install in one click on Cloud

7-day free trial · No credit card

  • 7-day free trial
    No credit card required
  • GDPR & SOC 2 ready
    EU data residency, audit logs
  • Open-source on GitHub
    Open source · AGPL-3.0
  • Works with ChatGPT, Claude, Gemini
    Any MCP-compatible client

Summary

USPS APIs for shippers: validate US addresses and look up ZIP Codes, compare domestic and international prices, get delivery days and shipping options, track packages, and find Post Offices, drop-off sites and Parcel Lockers. Labels, refunds, pickups and SCAN Forms are included but switched off. Consumer Key and Secret of an app in the USPS Customer Onboarding Portal.

Guided setup

Connect USPS to Meta Muse in 2 minutes

Start a free trial on AnythingMCP Cloud, connect USPS in the guided setup, then add your MCP URL to Meta Muse. No code and no server to run.

No credit card · 7-day trial · Self-host alternative available

Try asking

Example prompts for USPS

Click any prompt to copy it. Paste into Claude, ChatGPT, Cursor, Gemini, Copilot or OpenClaw to run it against this connector.

USPS · live via MCP
Share
Opus 4.7

Claude is AI and can make mistakes. Please double-check responses.

💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → USPS, paste your credentials, mint an MCP API key and you're done. No Docker, no git clone, no local server.

USPS + Meta Muse

USPS APIs for shippers: validate US addresses and look up ZIP Codes, compare domestic and international prices, get delivery days and shipping options, track packages, and find Post Offices, drop-off sites and Parcel Lockers. Labels, refunds, pickups and SCAN Forms are included but switched off. Consumer Key and Secret of an app in the USPS Customer Onboarding Portal.

Prerequisites

See the full setup instructions baked into the connector (visible in the in-app store when you select the connector). The required environment variables for this connector are:

USPS_CLIENT_ID, USPS_CLIENT_SECRET, USPS_API_HOST

Step 1 — Get credentials

Setting up takes about 15 minutes.

  1. Open the USPS Customer Onboarding Portal at https://cop.usps.com/cop-navigator?wf=API and sign in with your USPS Business Account, or create one there. The portal prepares the account for the USPS APIs.
  2. Select My Apps at the top of the portal and add an app.
  3. Open the app. In Credentials copy the Consumer Key into USPS_CLIENT_ID and the Consumer Secret into USPS_CLIENT_SECRET.
  4. Choose the API address in USPS_API_HOST: production https://apis.usps.com, or the Testing Environment for Mailers https://apis-tem.usps.com. Both take the same production credentials. Labels made on the test host are watermarked and never charged. USPS publishes the test host for every API except Tracking, so keep production when you mainly track.
  5. Optional, for labels and contract prices: your CRID, Mailer ID and Enterprise Payment Account number in USPS_CRID, USPS_MID and USPS_EPS_ACCOUNT_NUMBER. The Business Service Administrator of your Business Customer Gateway account has them.

The connector sends the Consumer Key and Secret to /oauth2/v3/token on the chosen host (client credentials) and gets a bearer token valid for about 8 hours, which it reuses and renews by itself.

What a new app may use: every app starts with the USPS default product: OAuth, Addresses, Domestic Prices, International Prices, Locations, Service Standards, Shipping Options and Tracking. Addresses, prices, delivery days, shipping options, tracking, Post Offices and drop-off locations therefore work at once. Carrier Pickup, Payments, Labels, International Labels and SCAN Forms need USPS approval: ask for them with a USPS API service request on the Email Us page (https://emailus.usps.com/s/usps-APIs). The Labels APIs also need enrollment in USPS Ship (outbound and return labels) and an Enterprise Payment Account (EPS) that pays the postage. Parcel lockers (usps_find_parcel_lockers) and the international service standard (usps_get_international_service_standard) have scopes of their own; if they answer 403, ask USPS for them the same way.

Where to start: usps_get_city_state with a ZIP Code proves the connection. For a quote, usps_search_shipping_options returns prices and delivery dates for every service in one call; usps_search_domestic_prices and usps_search_international_prices give the price breakdown with extra services.

Addresses: usps_validate_address standardizes a US address and returns the ZIP+4, DPVConfirmation (Y confirmed, D secondary number missing, S secondary number not confirmed, N not confirmed), business (Y or N) and vacant. usps_get_zip_code finds the ZIP Code of a street in a city and state, usps_get_city_state the city and state of a ZIP Code. States are two-letter codes; only US addresses (including territories and military addresses) are covered.

Prices: packages are weighed in pounds and measured in inches; letters, flats and cards are weighed in ounces. price_type COMMERCIAL is what you pay for labels bought online, RETAIL is the Post Office counter price, CONTRACT needs account_type and account_number. usps_search_domestic_prices returns rateOptions with totalBasePrice, totalPrice and the extra services; usps_list_domestic_prices lists every eligible product with its SKU, rateIndicator and processingCategory, the values a label request needs. usps_search_letter_prices prices First-Class Mail letters, flats and postcards. Abroad: usps_search_international_prices (optionally with duties and taxes per item), usps_list_international_prices and usps_search_international_letter_prices. Mailing dates may be today up to 7 days ahead. Amounts are US dollars. USPS_GROUND_ADVANTAGE replaced First-Class Package Service and Retail Ground.

Delivery days: usps_get_delivery_estimates gives the scheduled delivery date for a mailing day, with the acceptance cut-off time (cutOffTime, HHMM local); usps_get_service_standards the standard number of days per mail class; usps_get_international_service_standard a sentence such as Estimated delivery in 5-9 business days. A service standard is a target, not a guarantee.

Tracking: usps_track_package for one number, usps_track_packages for up to 35 at once. Both use Tracking 3.2; the legacy Tracking 3.0 API retires on 31 July 2027. The answer has statusCategory, statusSummary, trackingEvents (eventTimestamp in local time of the event, GMTTimestamp in UTC), deliveryDateExpectation and uniqueTrackingID. A batch answers HTTP 207 when some numbers fail, and each failed number carries its own error. usps_register_tracking_notifications signs up to 3 email addresses for tracking emails and usps_request_proof_of_delivery has a proof of delivery letter emailed; both need the uniqueTrackingID of a tracking answer, send email from USPS and cost nothing.

Locations: usps_find_post_offices searches by ZIP Code, city and state, address or coordinates (radius in miles, 20 by default) and lists the hours of each service; usps_find_dropoff_locations lists the destination entry facilities for Parcel Select, USPS Connect and Package Services by destination ZIP Code; usps_find_parcel_lockers finds Parcel Lockers.

Pickups: usps_check_pickup_eligibility and usps_get_pickup only read. usps_schedule_pickup books the free Carrier Pickup (Monday to Saturday) and usps_cancel_pickup cancels one; both are switched off. A pickup cannot be changed here: cancel it and book a new one.

Labels (switched off): every label call needs a payment authorization token. usps_create_payment_authorization with your CRID, Mailer ID and EPS account returns paymentAuthorizationToken; pass it to usps_create_label, usps_create_return_label, usps_create_international_label, usps_cancel_label or usps_cancel_international_label. Labels come back as JSON: labelMetadata with the tracking number and postage, and labelImage in base64 (a 4x6 PDF by default). Creating a label buys postage from the EPS account. A cancel answers CANCELED, or DISPUTED with a disputeId when USPS opened a refund request. usps_get_payment_account reads the account and, with amount, tells whether the funds suffice. usps_create_scan_form puts many labels on one PS Form 5630 for a single acceptance scan. Switch these tools on only after USPS approved the Labels APIs, and try them on the test host first.

Errors: failures come as error with code, message and a list errors (title, detail, source.parameter). 400 names the wrong field; 401 means wrong credentials or an expired token; 403 means the app does not have that API (it is outside the default product); 404 means USPS found nothing, e.g. an unknown tracking number.

Limits: each app has a quota of calls per hour; a 429 means it is used up until the next hour. USPS raises the quota on request through the Email Us page. Dates are YYYY-MM-DD.

Step 2 — Install the adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Step 3 — Add the connector in Muse

Your server URL: in AnythingMCP, open MCP Servers → the server this connector is on, and copy its URL (https://cloud.anythingmcp.com/mcp/…). Use it wherever this guide shows YOUR_SERVER_ID.

Muse adds remote MCP servers as custom connectors and signs in to them with OAuth.

  1. In Muse, open Settings → Connectors and choose Add custom connector.
  2. Paste the MCP server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.
  3. Muse opens the AnythingMCP sign-in page: sign in and approve access.
  4. In a chat, ask Muse for something that needs the USPS tools.

You can also set it up from a chat, on the web, in the iOS and Android apps or in WhatsApp. Send Muse this message:

Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth

Self-hosting? Use your instance's public HTTPS address instead of https://cloud.anythingmcp.com. Muse connects from Meta's cloud, so localhost does not work.

Available tools

ToolWhat it does
usps_validate_addressValidate and standardize one US address. Returns address in USPS standard form (streetAddress, city, state, ZIPCode, ZIPPlus4)…
usps_get_city_stateLook up the city and state of a 5-digit ZIP Code. Returns city (in capitals), state (two letters) and ZIPCode. Cheap call, used as…
usps_get_zip_codeFind the ZIP Code and ZIP+4 of a street address in a city and state. Returns address with the standardized street, city, state…
usps_search_domestic_pricesPrice a domestic package across mail classes, extra services included. Returns rateOptions, one per eligible product, each with…
usps_list_domestic_pricesList every product a domestic package is eligible for, with its base price and no extra services. Returns rateOptions with…
usps_search_letter_pricesPrice a First-Class Mail letter, flat (large envelope) or postcard sent within the US. Returns totalBasePrice and rates (SKU…
usps_search_international_pricesPrice an outbound international package, extra services included and, on request, duties and taxes per item. Returns rateOptions, one per…
usps_list_international_pricesList every international product an outbound package is eligible for, with base prices and no extra services. Returns rateOptions with…
usps_search_international_letter_pricesPrice a First-Class Mail International letter, flat or postcard. Returns totalBasePrice, rates (SKU, description, price, fees)…
usps_get_delivery_estimatesEstimate the delivery date of mail accepted on a given day. Returns a list, one entry per mail class, with serviceStandard (days)…
usps_get_service_standardsGet the standard number of delivery days between two ZIP Codes per mail class. Returns a list with mailClass, days…
usps_get_international_service_standardGet the expected delivery time of an international mail class to a country. Returns countryCode, mailClass and…
usps_search_shipping_optionsCompare every way to ship one package in a single call: prices and delivery commitments together, domestic or international. Returns…
usps_track_packageTrack one USPS package with Tracking 3.2. Returns trackingNumber, uniqueTrackingID, mailClass, status, statusCategory (e.g.…
usps_track_packagesTrack up to 35 USPS packages in one call with Tracking 3.2. Returns one result per number with trackingNumber, uniqueTrackingID…
usps_register_tracking_notificationsSign up to 3 email addresses for USPS tracking emails about one package: expected delivery updates, delivery activity or all updates. Needs…
usps_request_proof_of_deliveryHave USPS email a proof of delivery letter (or an electronic return receipt) for a delivered package to up to 3 recipients. Needs the…
usps_find_post_officesFind Post Offices and other retail locations near a ZIP Code, an address or coordinates, closest first. Returns locations with…
usps_find_dropoff_locationsFind the destination entry facilities where you can drop off Parcel Select, USPS Connect and Package Services mail for a destination ZIP…
usps_find_parcel_lockersFind USPS Parcel Lockers by ZIP Code or by city and state. Returns a list of lockers with facilityID, locationName, locationAddress…
usps_check_pickup_eligibilityCheck whether USPS offers free Carrier Pickup at an address. Answers 200 with pickupAddress in standardized form when the address is…
usps_get_pickupGet a scheduled Carrier Pickup by confirmation number. Returns confirmationNumber, pickupDate and carrierPickupRequest (address…
usps_get_payment_accountCheck an Enterprise Payment Account or permit. Returns the account details and, when amount is given, sufficientFunds (true or false)…
usps_create_payment_authorizationGet the payment authorization token that every label call needs: names your business as PAYER and LABEL_OWNER with its CRID, Mailer ID and…
usps_create_labelBuy postage and create a domestic shipping label, paid from the Enterprise Payment Account in the payment authorization token. Returns…
usps_create_return_labelCreate a domestic return label for a customer to send a package back (to_address is your returns address, from_address the customer).…
usps_cancel_labelCancel an unused domestic label or ask for a postage refund. Returns trackingNumber, status (CANCELED, or DISPUTED when a refund…
usps_create_international_labelBuy postage and create an international label with its customs form (First-Class Package International Service, Priority Mail International…
usps_cancel_international_labelCancel an unused international label or ask for a postage refund. Returns the tracking number, status (CANCELED or DISPUTED) and the…
usps_schedule_pickupBook a free USPS Carrier Pickup for packages at your address (Monday to Saturday; same-day only until 2 am Central Time). Returns…
usps_cancel_pickupCancel a scheduled Carrier Pickup by confirmation number. Returns 200 when cancelled. Installed switched off: cancellations stay with a…
usps_create_scan_formCreate a SCAN Form (PS Form 5630) that links labels to one barcode, so a single scan at acceptance records every package. Returns…

Example prompts

  • "Where is USPS package 9400111899223197428490?"
  • "Is 1600 Pennsylvania Ave NW, Washington DC 20500 a valid address, and what is its ZIP+4?"
  • "Compare USPS prices and delivery dates for a 3 lb box from 10001 to 94105 shipped tomorrow."
  • "What does a 2 lb package to Toronto cost with USPS Priority Mail International?"
  • "Find Post Offices open on Saturday near ZIP 60614."

FAQ

Where do the USPS credentials come from? From an app in the USPS Customer Onboarding Portal (cop.usps.com), signed in with your USPS Business Account: open My Apps, add an app and copy its Consumer Key and Consumer Secret. Choose the production host or the Testing Environment for Mailers; both take the same credentials.

What works right away, and what needs USPS approval? Addresses, prices, delivery days, shipping options, tracking and locations work with every new app. Carrier Pickup, payments, labels and SCAN Forms need USPS approval through a USPS API service request; labels also need USPS Ship and an Enterprise Payment Account.

Which tools install switched off? The tools that buy or book: usps_create_payment_authorization, usps_create_label, usps_create_return_label, usps_cancel_label, usps_create_international_label, usps_cancel_international_label, usps_schedule_pickup, usps_cancel_pickup and usps_create_scan_form. Switch them on on the connector page once USPS has approved them and the AI should use them.

Where is Muse available? Meta currently offers Muse in the US and Canada, on the web, in the iOS and Android apps and in WhatsApp.

Does Meta review this connector? No. Meta doesn't review custom connectors. Muse sees only the tools you switched on for this MCP server in AnythingMCP, and you can disconnect it anytime under Settings → Connectors.

Next steps

Was this guide helpful?

Connect USPS to Meta Muse in 2 minutes

Start a free trial on AnythingMCP Cloud, connect USPS in the guided setup, then add your MCP URL to Meta Muse. No code and no server to run.

Related guides

Connectors

Connect USPS to ChatGPT via MCP: Rates and Tracking

USPS APIs for shippers: validate US addresses and look up ZIP Codes, compare domestic and international prices, get delivery days and shipping options, track packages, and find Post Offices, drop-off sites and Parcel Lockers. Labels, refunds, pickups and SCAN Forms are included but switched off. Consumer Key and Secret of an app in the USPS Customer Onboarding Portal.

Connectors

Connect USPS to Claude via MCP: Rates and Tracking

USPS APIs for shippers: validate US addresses and look up ZIP Codes, compare domestic and international prices, get delivery days and shipping options, track packages, and find Post Offices, drop-off sites and Parcel Lockers. Labels, refunds, pickups and SCAN Forms are included but switched off. Consumer Key and Secret of an app in the USPS Customer Onboarding Portal.

Connectors

Connect USPS to Microsoft Copilot via MCP

USPS APIs for shippers: validate US addresses and look up ZIP Codes, compare domestic and international prices, get delivery days and shipping options, track packages, and find Post Offices, drop-off sites and Parcel Lockers. Labels, refunds, pickups and SCAN Forms are included but switched off. Consumer Key and Secret of an app in the USPS Customer Onboarding Portal.

Connectors

Connect USPS to Cursor via MCP: Rates and Tracking

USPS APIs for shippers: validate US addresses and look up ZIP Codes, compare domestic and international prices, get delivery days and shipping options, track packages, and find Post Offices, drop-off sites and Parcel Lockers. Labels, refunds, pickups and SCAN Forms are included but switched off. Consumer Key and Secret of an app in the USPS Customer Onboarding Portal.

Connectors

Connect USPS to Gemini CLI via MCP: Shipping Rates

USPS APIs for shippers: validate US addresses and look up ZIP Codes, compare domestic and international prices, get delivery days and shipping options, track packages, and find Post Offices, drop-off sites and Parcel Lockers. Labels, refunds, pickups and SCAN Forms are included but switched off. Consumer Key and Secret of an app in the USPS Customer Onboarding Portal.

Connectors

USPS MCP Server: Addresses, Shipping and Tracking

USPS APIs for shippers: validate US addresses and look up ZIP Codes, compare domestic and international prices, get delivery days and shipping options, track packages, and find Post Offices, drop-off sites and Parcel Lockers. Labels, refunds, pickups and SCAN Forms are included but switched off. Consumer Key and Secret of an app in the USPS Customer Onboarding Portal.