USPS Holiday Shipping Deadlines MCP

io.github.theluckystrikePublished by GitHub account theluckystrikev1.0.0Updated Nov 5, 2026

USPS holiday shipping deadlines: Christmas send-by dates, days left, military and international.

VerifiedStreamable HTTPWeb executableLocation & LifestyleWeb Search & Scraping

Overview

AI-generated overview

Remote MCP server that gives an assistant current USPS holiday send-by dates, days left, and which mail service still reaches a destination by December 25.

What you can do
  • Look up every USPS holiday send-by date for the season, covering the lower 48, Alaska, Hawaii, Puerto Rico and territories, international regions and APO/FPO/DPO groups
  • Check a given ship date and destination to see each service's send-by date, days remaining and whether it is still on time, plus the slowest service still on time
  • Get send-by dates for a single APO/FPO/DPO ZIP code, including military service options
  • Receive structured JSON with a summary, as-of date and source, noting whether the data was read live or from a built-in table
When to use it
Useful in the run-up to Christmas when someone asks whether it is too late to ship, which USPS service still arrives by December 25, or what the deadline is for a state, country or military ZIP. It supplies this year's published dates and today's date in US Eastern time, which a model's memory usually gets wrong.
Requirements
A remote streamable HTTP endpoint; no token, sign-up or API key. Add the URL as a custom connector or HTTP MCP server in the client. Network access to the hosted server, which reads usps.com at call time and caches it for up to 6 hours. A local npm package is mentioned but not yet published.
Before you install
Dates are USPS recommendations for expected delivery, not guarantees, and only USPS is covered, not UPS or FedEx. If usps.com cannot be read, answers fall back to a built-in copy of the table, so check the reported data source. Country-to-region mapping covers about 120 common countries.

Installation

In SourceWeft

  1. Open USPS Holiday Shipping Deadlines MCP in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.theluckystrike%2Fusps-holiday-shipping-deadlines-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "usps-holiday-shipping-deadlines": {
      "type": "http",
      "url": "https://usps-holiday-shipping-deadlines-mcp.lipmichal.workers.dev/mcp"
    }
  }
}

README

usps-holiday-shipping-deadlines-mcp

USPS holiday shipping deadlines for AI assistants. Ask "is it too late to ship for Christmas?" and get the USPS recommended send-by date for each mail class, the days left from today, and which service still makes December 25.

This is a Model Context Protocol (MCP) server. It reads the USPS holiday shipping dates page at call time. It needs no API key. If usps.com cannot be read, it answers from a built-in copy of the 2026 table and says so in data_source and live_check.

Tools

ToolWhat it returns
get_usps_holiday_shipping_deadlinesEvery 2026 USPS send-by date for delivery before December 25: lower 48, Alaska, Hawaii, Puerto Rico and territories, nine international regions and APO/FPO/DPO ZIP groups, with days left from today (US Eastern).
check_holiday_ship_by_dateFor a ship date (default today) and a destination ("lower48", a state or territory, a country, a USPS region or an APO ZIP), each service with its send-by date, days left and whether it is still on time, plus the slowest service still on time.
get_military_mail_deadlineSend-by dates for one APO/FPO/DPO ZIP code (090-099, 340, 962-966).

Every result has structured JSON, a one-paragraph summary, as_of, source and more (a page on mcpstamp.com).

What it knows that your model does not

  • This year's dates. USPS publishes new send-by dates every fall, so a model's remembered dates are last year's.
  • Today's date in US Eastern time, so "how many days do I have" is exact.
  • The fine print. Ground Advantage to Alaska and Hawaii has no single date (USPS gives a 10-day or more service expectation), and Priority Mail Express Military is not offered to APO ZIP 093.

Install

Hosted (Claude.ai custom connector, ChatGPT developer mode)

Paste this URL. No token, no sign-up. It works now.

https://usps-holiday-shipping-deadlines-mcp.lipmichal.workers.dev/mcp

Claude Code

claude mcp add --transport http usps-holiday-deadlines https://usps-holiday-shipping-deadlines-mcp.lipmichal.workers.dev/mcp

Claude Desktop

Claude Desktop adds remote servers under Settings, Connectors, Add custom connector. Paste the URL above.

Cursor

Add to ~/.cursor/mcp.json:

json
{  "mcpServers": {    "usps-holiday-deadlines": { "url": "https://usps-holiday-shipping-deadlines-mcp.lipmichal.workers.dev/mcp" }  }}

VS Code

Add to .vscode/mcp.json:

json
{  "servers": {    "usps-holiday-deadlines": { "type": "http", "url": "https://usps-holiday-shipping-deadlines-mcp.lipmichal.workers.dev/mcp" }  }}

Local stdio (after npm release)

The npm package is not published yet. After it is, run it locally with Node 20 or newer:

claude mcp add usps-holiday-deadlines -- npx -y usps-holiday-shipping-deadlines-mcp

Example prompts

  • "Is it too late to ship a package for Christmas?"
  • "What is the last day to mail Christmas cards with USPS this year?"
  • "I'm mailing a gift to Germany on December 10. Which USPS service still gets there by Christmas?"
  • "When do I need to ship to APO 09021 for Christmas?"
  • "What are the USPS holiday shipping deadlines for Hawaii?"

Data sources

Full list with fetch dates in DATA_SOURCES.md.

Limitations

  • USPS dates are recommendations for expected delivery, not guarantees.
  • USPS only. UPS and FedEx publish their own holiday dates; their pages block automated reads, so they are not included.
  • Country to region mapping covers about 120 common countries. Others can be given as a USPS region name ("Europe", "Middle East").
  • The hosted server caches the USPS page for up to 6 hours.

More

More MCP servers that answer questions your assistant cannot answer alone are on mcpstamp.com.

Part of the Zovo MCP collection: https://mcp.zovo.one

Built by theluckystrike.

Development

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

License

MIT

Source: README.md at commit c2c936a

Tools

3

get_usps_holiday_shipping_deadlines

Get USPS holiday shipping deadlines

The USPS recommended send-by dates for delivery before December 25 for the current holiday season, read at call time from usps.com: Ground Advantage, First-Class Mail, Priority Mail and Priority Mail Express to the lower 48 and to Alaska, Hawaii, Puerto Rico and territories; First-Class Package International, Priority Mail International and Priority Mail Express International by world region; and APO/FPO/DPO military mail by ZIP group. Includes days left from today.

Takes no parameters.

check_holiday_ship_by_date

Check if a package still makes Christmas

For a ship date (default today, US Eastern) and a destination, lists each USPS service with its send-by date, days left and whether it is still on time for December 25, and names the slowest (usually cheapest) service still on time. Destination can be "lower48", a state or territory ("Alaska", "Hawaii", "Puerto Rico", "Guam"), a country ("Canada", "Germany", "Japan"), a USPS region ("Europe") or an APO/FPO/DPO ZIP ("APO 09021").

Parametersship_datedestination

get_military_mail_deadline

Get military mail holiday deadline

USPS holiday send-by dates for December 25 delivery to one APO/FPO/DPO ZIP code (090-099 AE, 340 AA, 962-966 AP): Ground Advantage, First-Class Mail, Priority Mail and Priority Mail Express Military Service.

Parametersziprequired

Version history

1
  1. v1.0.0LatestNov 5, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts