Every change Wellknown observed on this MCP server, newest first, with what it was before and what it became. Tool-surface changes carry the definition diff. Nothing here is edited after the fact.
Changed the definition of "decode", "read_source", "search" and 2 more
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 ⟨19 unchanged words⟩
⟨14 unchanged words⟩ or 34 with 420 and the ZIP Code. Or a letter's or flat's Intelligent Mail barcode: its 20, 25, 29 or 31 digits, or its 65 bars as A, D, F and T from the left. Spaces and dashes are fine.","maxLength":80160,"type":"string"}},"required":[ ⟨3 unchanged words⟩
⟨3 unchanged words⟩ document":{"description":"A document's id,asthe `id` search_documentsgivesanditsearch_text give: a modeled one, such as pub-199 or ⟨130 unchanged words⟩
⟨82 unchanged words⟩ ). 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 term ⟨13 unchanged words⟩
⟨26 unchanged words⟩ Each one postalref holds the text of carriestheanid`id`, which read_sourcereadstakesitasby.`document`. A title says only that USPS publishes a document:read_source the `id` ofread one it lists with read_source to learn what it says.
Search the text of every document postalref holds, or of one, for the pages that say the words, best ⟨27 unchanged words⟩ or close together, a table of contentslast,last.andA document gives at most three pages while other documents' pages fill the list, and `more` gives each document adocument.hit is from that has more pages with the words, and how many: search again with its id as `document` to rank only its pages. A page needn't have the words a question ⟨122 unchanged words⟩ with the hit's `id` and `page`, orread_sourcegive them to read_source as `document` and `page` for the sentences around it. When no hit ⟨10 unchanged words⟩
Changed the definition of "read_source" and "search_text"
⟨92 unchanged words⟩ number, as `page`. When the text ends mid-sentence,or mid-list,or`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`.
{"additionalProperties":true,"properties":{"continued":{"additionalProperties":true,"properties":{"label":{"type":"string"},"page":{"additionalProperties":true,"properties":{"pdf":{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},"printed":{"type":"string"}},"required":["pdf"],"type":"object"},"text":{"type":"string"}},"required":["label","text"],"type":"object"},"Changed the definition of "decode", "define", "lookup" and 4 more
⟨29 unchanged words⟩ 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.
{"additionalProperties":false,"properties":{"barcode":{"description":"The digits under a package barcode, or all 30 or 34 with 420 and the ZIP Code. Spaces and dashes are fine.","maxLength":80,"type":"string"}}," ⟨4 unchanged words⟩
Added "search_text"; changed the definition of "define", "diff", "lookup" and 2 more (7 tools before, 8 now)
⟨30 unchanged words⟩ ,"quote":{"type":"string"},"read":{"additionalProperties":true,"properties":{"document":{"type":"string"},"page":{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"}},"required":["document"],"type":"object"},"url":{"type":"string"}},"required ⟨22 unchanged words⟩ ,"quote":{"type":"string"},"read":{"additionalProperties":true,"properties":{"document":{"type":"string"},"page":{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"}},"required":["document"],"type":"object"},"url":{"type":"string"}},"required ⟨166 unchanged words⟩ ,"quote":{"type":"string"},"read":{"additionalProperties":true,"properties":{"document":{"type":"string"},"page":{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"}},"required":["document"],"type":"object"},"url":{"type":"string"}},"required ⟨18 unchanged words⟩ ,"type":"object"},"type":"array"},"match":{"enum":["definition"],"type":"string"},"query":{"type":"string"} ⟨13 unchanged words⟩
Certificate recorded, valid to 2027-01-29
Authorization not required
Changed the definition of "diff"
⟨99 unchanged words⟩ ,"ratedBy":{"enum":["rule","person","model","pending"],"type":"string"} ⟨202 unchanged words⟩
Changed the definition of "define"
⟨42 unchanged words⟩ it has one, and postalref's page about it. An entry USPS ended says when, what replaced it, and USPS's words that say so; one renamed gives its former names, each with USPS's words.
⟨42 unchanged words⟩ ,"explained":{"type":"string"},"former":{"items":{"additionalProperties":true,"properties":{"document":{"type":"string"},"name":{"type":"string"},"page":{"type":"string"},"quote":{"type":"string"},"url":{"type":"string"}},"required":["name","quote","document","url"],"type":"object"},"type":"array"},"id":{"type":"string"},"is" ⟨134 unchanged words⟩ "string"},"page":{"type":"string"},"retired":{"additionalProperties":true,"properties":{"by":{"type":"string"},"document":{"type":"string"},"on":{"type":"string"},"page":{"type":"string"},"quote":{"type":"string"},"url":{"type":"string"}},"required":["quote","document","url"],"type":"object"},"tier":{"enum":["core" ⟨30 unchanged words⟩
Changed the definition of "define", "lookup" and "search"
⟨6 unchanged words⟩ or abbreviation: each registry entry it names, in the order search ranks them, with its kind and tier, the USPS words that define it and the ⟨18 unchanged words⟩
⟨17 unchanged words⟩ definition":{"additionalProperties":true,"properties":{"dated":{"type":"string"},"document":{"type":"string"},"page" ⟨17 unchanged words⟩ ,"id":{"type":"string"},"is":{"items":{"anyOf":[{"additionalProperties":true,"properties":{"_tag":{"enum":["Product"],"type":"string"},"node":{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"}},"required":["_tag","node"],"type":"object"},{"additionalProperties":true,"properties":{"_tag":{"enum":["Document"],"type":"string"},"node":{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"}},"required":["_tag","node"],"type":"object"},{"additionalProperties":true,"properties":{"_tag":{"enum":["Spec"],"type":"string"},"spec":{"type":"string"}},"required":["_tag","spec"],"type":"object"},{"additionalProperties":true,"properties":{"_tag":{"enum":["Field"],"type":"string"},"key":{"type":"string"},"spec":{"type":"string"}},"required":["_tag","spec","key"],"type":"object"},{"additionalProperties":true,"properties":{"_tag":{"enum":["Table"],"type":"string"},"table":{"type":"string"}},"required":["_tag","table"],"type":"object"},{"additionalProperties":true,"properties":{"_tag":{"enum":["Code"],"type":"string"},"code":{"type":"string"},"table":{"type":"string"}},"required":["_tag","table","code"],"type":"object"}]},"type":"array"},"
Unknown → Live
First tool surface recorded: 7 tools (server version 0.1.0)
https://postalref.com/mcp (mcp_streamable_http) — from mcp_registry, with the record
Showing the latest 12 events. The API returns up to 500 and filters by kind: ?kind=tool_surface_changed
⟨50 unchanged words⟩ ,"some"],"type":"string"},"more":{"items":{"additionalProperties":true,"properties":{"id":{"type":"string"},"pages":{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"}},"required":["id","pages"],"type":"object"},"type":"array"},"query":{"type":"string"},"total" ⟨13 unchanged words⟩
⟨68 unchanged words⟩ 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 id and page read_source reads, and thewordspassagearoundthatthem.says most of the words. Use it when no title names what you're ⟨13 unchanged words⟩ rule in a DMM chapter. A hit's `context`shows whereistheawordswholeare:sentence,read_sourcelistitsor`id`rowandof`page`thetopagequoteunlesstheitpage.startsWhenornoendshitwithanswers,…:searchquoteagainit withotherthewordshit's `id` and `page`,suchorasread_source them for theterm'ssentencesotheraroundnamesit.andWhenabbreviationsno hit answers,orsearch again with the words an answer would say.
⟨39 unchanged words⟩ forms: one or many, -ed, -ing,-able.-able, -ous.","maxLength":200,"type":"string"} ⟨4 unchanged words⟩
⟨4 unchanged words⟩ items":{"additionalProperties":true,"properties":{"by":{"type":"string"},"context":{"type":"string"},"id" ⟨55 unchanged words⟩
⟨82 unchanged words⟩ : 55 finds PTR's 55, then STC's 055. Cite a row by its passage, revision and page, with its cells' words as printed.
⟨38 unchanged words⟩ surcharge-types, zones, impb-noncompliance-codes, impb-noncompliance-report-codes, acs-product-codes, acs-move-types, acs-coa-deliverability-codes, acs-nixie-codes, dpv-return-codes, dpv-footnotes, ptr, ptr2, stid, opcodes, unexpected-opcodes, ncoalink-return-codes ⟨12 unchanged words⟩
⟨40 unchanged words⟩ and a quote from one cites no page. Quote whole sentences, word for word, from a page's `text` or a `found` context, which shows the whole sentence around the words, or the lead-in with the list it opens. Read another page `found` lists by its `pdf` number, or a part by its number, as `page`. When the text ends mid-sentence, mid-list or mid-table, read `next`.
⟨88 unchanged words⟩ more digits comes back as one to decode. A term hit's slug goes to define, and a code's to lookup with its table.
⟨32 unchanged words⟩ of carries the id read_source reads it by. A title says only that USPS publishes a document: read_source the `id` of one it lists to learn what it says.
⟨106 unchanged words⟩ Schedule or a rule in a DMM chapter. A hit's `context` shows where the words are: read_source its `id` and `page` to quote the page. When no hit answers, search again with other words, such as the term's other names and abbreviations, or the words an answer would say.
⟨11 unchanged words⟩ :"string"},"type":"array"},"carried":{"additionalProperties":true,"properties":{"by":{"type":"string"},"from":{"type":"string"},"on":{"type":"string"}},"required":["from","by"],"type":"object"},"change":{"enum":["added","removed" ⟨291 unchanged words⟩
⟨23 unchanged words⟩ to look in: stc, extra-services, mail-classes, channel-application-ids, container-types, delivery-option-indicators, rate-indicators, destination-rate-indicators, discount-types, open-and-distribute-content-indicators, postal-routing-barcodes, processing-categories, surcharge-types, zones, impb-noncompliance-codes, impb-noncompliance-report-codes, acs-product-codes, ptr, ptr2, stid, opcodes, unexpected-opcodes, ncoalink-return-codes orstid.ncoalink-return-code-matrix. Every table when absent.","type":"string ⟨4 unchanged words⟩
Reada revision of aanymodeleddocumentUSPSpostalrefdocumentholds page by page, as extracted, to quote ⟨6 unchanged words⟩ sha256, the PDF page and the words exactly. A text without pages, a web page or a product page, reads in parts, and a quote from one cites no page.
{"additionalProperties":false,"properties":{"document":{"description":"Amodeleddocument'sdocumentid, as search_documents gives it:pub-199,aimpb-spec,modeledstc-listone,ptr-events,suchptr2-events,asstid-tablepub-199 or impb-spec; node-4649 for another PostalPro file; postalpro-855 for a PostalPro product page; or a download such as pdf-pub52,imb-specdmm-505 orparcel-labeling-guide.web-prc-mcs-2026-07.","type":"string"},"find":{ ⟨37 unchanged words⟩ :{"description":"The first PDF page, sheet orsheet,part to read, counting from 1. Absent with ⟨54 unchanged words⟩
⟨57 unchanged words⟩ ,"words"],"type":"string"},"next":{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},"parts":{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},"revision":{"anyOf":[{"additionalProperties":true,"properties":{"copies":{" ⟨71 unchanged words⟩ ","format"],"type":"object"},{"revisionsadditionalProperties":true,"properties":{"itemsdate":{"additionalPropertiestype":true"string"},"propertiesdocument":{"type":"string"},"fetched":{"type":"string"},"format":{"type":"string"},"from":{"enum":["xlsxproduct","download"],"type":"string"},"sha256original
⟨8 unchanged words⟩ file name, with its page and newestfile.file, and the product pages and downloads postalrefmodelsholdsabyfewtitle. Each one postalref holds the text ofthem;carriesthosethecarryidaread_sourceslugreadsforitread_source.by.
{"additionalProperties":true,"properties":{"documents":{"items":{"anyOf":[{"additionalProperties":true,"properties":{"changed":{" ⟨17 unchanged words⟩ ,"link"],"type":"object"},"id":{"type":"string"},"kinds":{"items":{"type":"string" ⟨40 unchanged words⟩ "changed","url"],"type":"object"},{"additionalProperties":true,"properties":{"fetched":{"type":"string"},"from":{"enum":["product","download"],"type":"string"},"id":{"type":"string"},"nid":{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},"title":{"type":"string"},"url":{"type":"string"}},"required":["id","title","url","from","fetched"],"type":"object"}]},"type":"array"},"query":{ ⟨15 unchanged words⟩
Search the text of documents — Search the text of every document postalref holds 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, and at most three pages a document. A page needn't have the words a question asks with, such as how, get or take. Each hit gives the id and page read_source reads, and the words around them. 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.
⟨29 unchanged words⟩ 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.
Search the codes, terms, banner texts, specs and documents postalref models,exactby one index: names and codesfirst.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 comes ⟨5 unchanged words⟩
⟨21 unchanged words⟩ ["Term"],"type":"string"},"slugdated":{"type":"string"},"is":{"items":{"anyOf":[{"additionalProperties":true,"properties":{"_tag":{"enum":["Product"],"type":"string"},"node":{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"}},"required":["_tag","slugnode"],"type":"object"},{"additionalProperties" ⟨4 unchanged words⟩ ["Document"],"type":"string"},"slugnode":{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"}},"required":["_tag","node"],"type":"object"},{"additionalProperties":true,"properties":{"_tag":{"enum":["Spec"],"type":"string"},"spec":{"type":"string"}},"required":["_tag","slugspec"],"type":"object"},{"additionalProperties":true,"properties":{"_tag":{"enum":["TableField"],"type":"string"},"slugkey":{"type":"string"},"spec":{"type":"string"}},"required":["_tag","slugspec","key"],"type":"object"},{"additionalProperties":true,"properties":{"_tag":{"enum":["SpecTable"],"type":"string"},"slugtable":{"type":"string"}},"required":["_tag","slugtable"],"type":"object"},{"additionalProperties":true,"properties":{"_tag":{"enum":["FieldCode"],"type":"string"},"keycode":{"type":"string"},"spectable":{"type":"string"}},"required":["_tag","spectable","keycode"],"type":"object"}]},"type":"array"},"kind":{"enum":["mail-class","extra-service","service","program","system","file","identifier","document","facility","container","role","term"],"type":"string"},"slug":{"type":"string"},"tier":{"enum":["core","reference"],"type":"string"}},"required":["_tag","slug","kind","tier"],"type":"object"},{"additionalProperties":true,"properties":{"_tag":{" ⟨10 unchanged words⟩ ,"required":["_tag","table","code"],"type":"object"},{"additionalProperties":true,"properties":{"_tag":{"enum":["Value"],"type":"string"},"column":{"type":"string"},"table":{"type":"string"},"value":{"type":"string"}},"required":["_tag","table","column","value"],"type":"object"}]},"name ⟨28 unchanged words⟩