Read a page of postalref.com
readRead a page of postalref.com by its path. /glossary/ gives what USPS means by a term: its entry, with its kind and tier, the USPS words that define it and the page they're on, its other names, postalref's own explanation where it has one, and when USPS ended or renamed it, each with USPS's words; /glossary/, such as /glossary/mailer-id or /glossary/MID, gives the entries those words name, in the order search ranks them. /codes//, such as /codes/service-type-codes/055, gives a code's row as USPS prints it in the newest edition that lists it, the editions that list it and its history. /documents/ gives any document postalref holds, page by page as extracted, to quote, and /documents lists them. Any other path is a page of the site, given as its Markdown: a product page (/products/), a guide (/guides/), a code table's home (/codes/), a case (/cases/), a spec (/specs/), a topic (/topics/) or /changes. Quote whole sentences, word for word. A definition's words cite its document and page, and its read names the document and page to read for the sentences around them. A document's text, or a found context, which shows the whole sentence around the words or the lead-in with the list it opens, cites the revision's sha256, the PDF page and the words exactly; read another page found lists by its pdf number, or a part by its number, as page. When the text ends mid-sentence or mid-list, continued gives the rest of it from next, cited by its own page; when it ends mid-table, or a list goes on past continued, read next. A text without pages, a web page or a product page, reads in parts, and a quote from one cites no page.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"path": "<path>"
},
"name": "read"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| find | No | With /documents/<id>: words to find, as one phrase, or when no page has the phrase, each word anywhere on a page. Without `page`, the text read is the first pages that have them. | |
| page | No | With /documents/<id>: the first PDF page, sheet or part to read, counting from 1; absent with `find`, the pages that have the words. With /documents: the page of the list, 100 documents a page. | |
| path | Yes | A path of postalref.com, as search and grep give each hit's `path`, or a page's address on the site: /glossary/mid, /glossary/mailer-id, /codes/service-type-codes/055, /documents/pub-199, /documents, /products/mid. | |
| pages | No | With /documents/<id>: how many to read, up to 5; 1 when absent. | |
| revision | No | With /documents/<id>: a revision's sha256, or its slug, such as 2026-07-02. The newest when absent. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| code | No | ||
| list | No | ||
| path | Yes | ||
| term | No | ||
| document | No | ||
| markdown | No |