# About postalref

postalref reads USPS documents and code tables, and links what it says about USPS to the words it comes from.

## What postalref is

postalref is an unofficial reference to USPS rules and codes. It's for people who prepare mail, ship packages or build software for mail, and for the agents that work for them.

postalref explains USPS's public documents in plain words. It isn't affiliated with or endorsed by the United States Postal Service.

## Where the data comes from

Most of what postalref says comes from PostalPro, the USPS site for the mailing industry. postalref reads PostalPro's catalog of documents and downloads the files of the ones it covers: publications, technical specifications and code tables.

It keeps every version of each file it downloads, so a fact can name the version it comes from. When it reads PostalPro again, it downloads only the files that changed. Its crawler sends at most one request a second and names postalref in each one.

The pages also quote public documents from outside PostalPro, each kept as postalref saved it:

- the Domestic Mail Manual and the International Mail Manual
- other USPS publications, handbooks, forms and annual reports
- the Postal Bulletin and USPS's own websites
- USPS notices in the Federal Register
- the Mail Classification Schedule, which the Postal Regulatory Commission keeps
- reports of the USPS Office of Inspector General
- a federal court filing

## How a document is read

postalref reads each file's text a page at a time and keeps the number each page prints. A citation shows that number and links the PDF at its page.

A table in a PDF is read twice. A row counts only when every cell is in the PDF's text and a model's second reading agrees with it cell for cell. Any other row is left out and listed as unchecked, so a row postalref couldn't read is never taken for a code USPS removed.

## How each fact is cited

A fact cites the words it comes from in a document postalref holds. Before the site is built, postalref looks for each cited passage where its citation says it is. A citation whose words aren't there stops the build, so the site never shows one.

On the site, a cited sentence ends in a small number. The number opens the words it rests on, the document they're in, and a link to the original.

## How the pages are written

Claude, a model made by Anthropic, reads each product's documents and writes its page as data. A page marks each claim with the quote it rests on, kept word for word. A guide, a page about one subject across several products, is written the same way.

A checker reads every page before it's published, and stops one that has any of these:

- a quote whose words aren't on the page it names
- a paragraph of USPS's facts that cites nothing
- an example tracking number that fails its checks
- a rule explained in words that change its strength, such as a should turned into a must

A page never copies a code table's rows, a decoded number or a term's definition. They come from the data when the site is built. Each page shows the day it last changed.

## How a change is found

For each new file of a code table, postalref compares it with the file before. It records each code added or changed, and each one removed or retired. A rule, a model or a person rates each change as breaking, additive or editorial. The site says when a model rated one.

When a document's new version rewords a passage a fact cites, the fact keeps citing the older version, which still says it. postalref lists the passage for review.

## For agents

An agent can add postalref as an MCP server at `https://postalref.com/mcp`. Its tools only read, and they answer from the same checked data as the site:

- decode a tracking number or package barcode
- look up a code, its row and its history
- compare two editions of a code table or a document
- search the codes, terms and documents postalref holds
- say what USPS means by a name or abbreviation
- read a document's pages, or search their text

Ask answers a question in plain words. DeepSeek V4.1 Flash, a model reached through OpenRouter, reads postalref's data with seven of the same tools. The answer keeps each citation it can place, names any it can't, and lists every tool call.

## Where it runs

postalref runs on Cloudflare as one Worker, a program Cloudflare runs on its own servers. The Worker serves the site's pages, which are drawn ahead of time, and answers the MCP server and Ask.

The [tools](https://postalref.com/tools) work in your browser, so a number you type into them isn't sent to postalref.

## Reporting a mistake

If a page says something its source doesn't, write to [support@postalref.com](mailto:support@postalref.com) with the page's address and the source.

---

Unofficial. Not affiliated with or endorsed by the United States Postal Service. This is https://postalref.com/about as Markdown.
