postalref
Server Details
USPS package barcodes, service type codes and mailing terms, each cited to its USPS source.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 6 tools
lookup and read both return a code’s row, editions and history when reading /codes paths, so an agent may hesitate between them. search and grep also overlap in document discovery, though their core purposes (index lookup vs full-text page search) are described distinctly.
All six tools use single lowercase verb-style names: decode, diff, grep, lookup, read, search. The pattern is highly consistent with no mixed casing or verb/noun conventions.
Six tools is well-scoped for a USPS reference server: decode, diff, grep, lookup, read and search each cover a distinct facet of the domain. There is no excessive tool proliferation or obvious under-provisioning.
The surface covers barcode decoding, edition diffs, full-text document search, code lookup, page reading, and index search, which is strong for a reference domain. Minor gaps exist around direct browsing/list operations, though read and search can approximate them.
Available Tools
6 toolsdecodeDecode a barcodeARead-onlyIdempotentInspect
Read a package barcode or tracking number (IMpb), or a letter's or flat's Intelligent Mail barcode (IMb) from its digits or bars: its layout, each field's digits and meaning, whether the check digit or the bars' frame check holds, and the service type code's or Service Type ID's row in the USPS list, each with the passage that says so. A field's meaning is postalref's words: quote a cite's lit, USPS's, with its passage.
Inputs: barcode (required). Returns: spec, checks, digits, fields, +3 more
diffCompare two editionsARead-onlyIdempotentInspect
What changed in a code table or document between two editions: each code added, removed or changed and each changed section, rated editorial, additive or breaking, with who rated it.
Inputs: subject (required), to, code, from, +2 more. Returns: to, from, total, counts, +3 more
grepSearch the documentsARead-onlyIdempotentInspect
Search the text of every document postalref holds, or of one, for the pages that say the words, best first: those that say them as a phrase, then by how much of the page they are and how many of them it says side by side or close together, a table of contents last. A court's filing or a Justice Department release about a fraud case comes after USPS's own pages when one of those says every word, as Publication 52 and a release about a bulk mail fraud both say bulk mail permit; a case's name finds its records first. A document gives at most three pages while other documents' pages fill the list, and more gives each document a hit is from that has more pages with the words, and how many: grep again with /documents/ as path to rank only its pages. A page needn't have the words a question asks with, such as how, get or take. Each word is found in its forms, and a name also as the registry's other names for it, BCG for Business Customer Gateway or Post Office Box for PO Box, and a size as 4x6 or 4 x 6; a hit another wording found gives it as by. Each hit gives the path and page read reads, and the passage that says most of the words. Use it when no title names what you're looking for, as for a price in the Mail Classification Schedule or a rule in a DMM chapter. With /documents as path, it searches every document on PostalPro by title and file name instead, with its page and newest file, and the product pages and downloads postalref holds by title; each one postalref holds the text of carries the path read takes. A hit's context is a whole sentence, list or row of the page unless it starts or ends with …: quote it with the hit's id and page, or read its path at that page for the sentences around it. When no hit answers, grep again with the words an answer would say. A title says only that USPS publishes a document: read one grep lists to learn what it says.
Inputs: query (required), path, limit, topic. Returns: pages, titles
lookupLook up a codeARead-onlyIdempotentInspect
Look up a USPS code: its row as USPS prints it in the newest edition that lists it, the codes its cells name, the editions that list it and its history, each row with its passage id. A code is found without the marks USPS prints around it and in a row USPS prints for several codes: 750 finds 750, 858 finds 858 and the dropped 858*, and 13 finds PTR's row 01 / 13. Two digits are also tried as three: 55 finds PTR's 55, then STC's 055. Cite a row by its passage, revision and page, with its cells' words as printed, and a row's notes, the footnotes its marks point to, by their own revision and page.
Inputs: code (required), table. Returns: matches
readRead a page of postalref.comARead-onlyIdempotentInspect
Read 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.
Inputs: path (required), find, page, pages, +1 more. Returns: code, list, path, term, +2 more
searchSearch codes and termsARead-onlyIdempotentInspect
Search the codes, terms, banner texts, specs and documents postalref models, by one index: names and codes whose key is the query's first, then those that start with it, then those with words that start with its words, then codes whose row has its words. A term hit carries its kind (mail-class, extra-service, service, program, system, file, identifier, document, facility, container, role or term) and its tier (core, or reference: only in Publication 32, the glossary of July 2013, with that date). A query of 20 or more digits, or an Intelligent Mail barcode's 65 bars as A, D, F and T, comes back as one to decode. A hit's path goes to read: a term's entries, a code's row and history. A code also goes to lookup with its table.
Inputs: query (required), limit. Returns: hits, query, total, decode
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
GS1 check digits, code identification, UPC-E and ISBN conversion, barcodes and LTL freight class.
Postal lookups for 120 countries with cited sources; deep US tier: demographics, climate, area codes
EAN, UPC & Code 128 barcodes
Find USPS pickup points, compare USPS and UPS rates, track USPS packages. No sign-in.
Related MCP Servers
- AlicenseAqualityBmaintenanceLive USPS, UPS, FedEx and DHL Express parcel rates from a US origin, domestic or to Canada, the UK, Germany and Australia, from a plain-words item description: no scale, no account, no API key. Also creates checkout links, reports checkout status, tracks parcels bought on smklog.com and serves a monthly US parcel price index.101MIT
- AlicenseAqualityBmaintenanceEnables AI assistants to retrieve current USPS retail postage prices from Notice 123, including Forever stamps, postcards, international letters, flat-rate boxes, and letter postage by weight with effective dates.3MIT
- AlicenseAqualityDmaintenanceGlobal postal code lookups, validation, and city search for 240+ countries with timezone, admin region, and elevation metadata. Sub-10ms responses at $0.000028/query with 1,000 free queries on signup.41MIT
- AlicenseAqualityDmaintenanceMulti-carrier parcel tracking server that communicates directly with carrier APIs (DHL, UPS, FedEx, etc.) without third-party aggregators, providing normalized tracking status and events.31MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.