{"data":{"name":"com.postalref/postalref","title":"postalref","description":"USPS package barcodes, service type codes and mailing terms, each cited to its USPS source.","version":"0.3.0","websiteUrl":"https://postalref.com","repositoryUrl":null,"remotes":[{"type":"streamable-http","url":"https://postalref.com/mcp"}],"packages":[],"status":"active","isLatest":true,"publishedAt":"2026-11-19T20:01:19.179Z","updatedAt":"2026-11-19T20:01:19.179Z","source":"official-registry","verification":"official","confidence":100,"stars":null,"sources":[{"source":"official-registry","sourceId":"com.postalref/postalref","verification":"official","confidence":100,"stars":null,"updatedAt":"2026-11-19T20:01:19.179Z","title":"postalref","description":"USPS package barcodes, service type codes and mailing terms, each cited to its USPS source.","websiteUrl":"https://postalref.com","repositoryUrl":null}],"toolIndex":{"tools":[{"serverName":"com.postalref/postalref","endpointFingerprint":"d75df41373326013ccdff281549373d44a89ab158ce5e7cc2bd224e5e05c5502","name":"decode","title":"Decode a barcode","description":"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.","inputSchema":{"type":"object","properties":{"barcode":{"type":"string","maxLength":160,"description":"The digits under a package barcode, or all 30 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."}},"required":["barcode"],"additionalProperties":false},"annotations":{"title":"Decode a barcode","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"351f32d892199f1fac116fa8b7b2023728898f69b577b4ef3433e78b4b675e8a","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T06:46:36.630Z","metadataTrust":"untrusted"},{"serverName":"com.postalref/postalref","endpointFingerprint":"d75df41373326013ccdff281549373d44a89ab158ce5e7cc2bd224e5e05c5502","name":"define","title":"Define a USPS term","description":"What USPS means by a name 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 page they're on, its other names, postalref's own explanation where 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. Quote a definition's words as they are, citing its document and page; its `read` names the document and page read_source reads them on, with the sentences around them.","inputSchema":{"type":"object","properties":{"name":{"type":"string","maxLength":120,"description":"A name or abbreviation USPS uses: mailer id, MID, CRID, banner text."},"limit":{"type":"integer","minimum":1,"maximum":20,"description":"At most this many entries; 5 when absent."}},"required":["name"],"additionalProperties":false},"annotations":{"title":"Define a USPS term","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"e854391c53e563acf00723ea630da37cc62e65611bd6cb43497a3b611e3aeb9b","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T06:46:36.630Z","metadataTrust":"untrusted"},{"serverName":"com.postalref/postalref","endpointFingerprint":"d75df41373326013ccdff281549373d44a89ab158ce5e7cc2bd224e5e05c5502","name":"diff","title":"Compare two editions","description":"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.","inputSchema":{"type":"object","properties":{"subject":{"type":"string","description":"A code table, such as stc, ptr or extra-services, or a document, such as pub-199 or impb-spec."},"code":{"type":"string","maxLength":40,"description":"One code of the table."},"from":{"type":"string","description":"The older edition's date. The edition before `to` when absent."},"to":{"type":"string","description":"The newer edition's date. The newest when absent."},"severity":{"type":"string","enum":["editorial","additive","breaking"],"description":"Only changes rated this."},"limit":{"type":"integer","minimum":1,"maximum":200,"description":"At most this many changes; 50 when absent."}},"required":["subject"],"additionalProperties":false},"annotations":{"title":"Compare two editions","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"f1203546331e6c69d00f800bcb0a5c54fe6ce694ffde0407aee0ff4bd0a5500c","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T06:46:36.630Z","metadataTrust":"untrusted"},{"serverName":"com.postalref/postalref","endpointFingerprint":"d75df41373326013ccdff281549373d44a89ab158ce5e7cc2bd224e5e05c5502","name":"lookup","title":"Look up a code","description":"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.","inputSchema":{"type":"object","properties":{"code":{"type":"string","maxLength":40,"description":"A code as USPS prints it: 055, 920, PM, 01."},"table":{"type":"string","description":"One table 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, acs-move-types, acs-coa-deliverability-codes, acs-nixie-codes, acs-address-types, acs-fee-notification-codes, acs-notification-types, acs-mail-action-codes, acs-dpv-codes, dpv-return-codes, dpv-footnotes, ptr, ptr2, stid, opcodes, unexpected-opcodes, ncoalink-return-codes, ncoalink-return-code-matrix, lacslink-return-codes, maildat-pre-validation-errors, maildat-client-errors, maildat-client-warnings, maildat-server-errors, maildat-server-warnings, maildat-client-info, impb-quality-validations, impb-cew-messages, impb-international-scan-events, impb-edi-event-codes, impb-barcode-constructs, impb-pc-postage-barcode-constructs, impb-container-barcode-constructs, impb-tray-sack-barcode-constructs, mqd-container-errors, mqd-handling-unit-errors, mqd-bundle-errors, mqd-piece-range-errors or mqd-piece-errors. Every table when absent."}},"required":["code"],"additionalProperties":false},"annotations":{"title":"Look up a code","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"5f582dafe55accc74b249a7245aaf13e8e69f674e8aeb411a76e98005e3a8004","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T06:46:36.630Z","metadataTrust":"untrusted"},{"serverName":"com.postalref/postalref","endpointFingerprint":"d75df41373326013ccdff281549373d44a89ab158ce5e7cc2bd224e5e05c5502","name":"read_source","title":"Read a USPS document","description":"Read any document postalref holds page by page, as extracted, to quote it: a quote cites the revision's 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. 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 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`.","inputSchema":{"type":"object","properties":{"document":{"type":"string","description":"A document's id, the `id` search_documents and search_text give: a modeled one, such as pub-199 or impb-spec; node-4649 for another PostalPro file; postalpro-855 for a PostalPro product page; or a download such as pdf-pub52, dmm-505 or web-prc-mcs-2026-07."},"revision":{"type":"string","maxLength":64,"description":"A revision's sha256, or its slug, such as 2026-07-02. The newest when absent."},"page":{"type":"integer","minimum":1,"maximum":9007199254740991,"description":"The first PDF page, sheet or part to read, counting from 1. Absent with `find`: the pages that have the words."},"pages":{"type":"integer","minimum":1,"maximum":5,"description":"How many to read, up to 5; 1 when absent."},"find":{"type":"string","maxLength":200,"description":"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."}},"required":["document"],"additionalProperties":false},"annotations":{"title":"Read a USPS document","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"74c1ea051370425ba5b63ff354e8257e90698302134c3c851192779c91ad02a8","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T06:46:36.630Z","metadataTrust":"untrusted"},{"serverName":"com.postalref/postalref","endpointFingerprint":"d75df41373326013ccdff281549373d44a89ab158ce5e7cc2bd224e5e05c5502","name":"search","title":"Search codes and terms","description":"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 term hit's slug goes to define, and a code's to lookup with its table.","inputSchema":{"type":"object","properties":{"query":{"type":"string","maxLength":120,"description":"A code, a term or words from a code's row: 055, mailer id, ground advantage."},"limit":{"type":"integer","minimum":1,"maximum":50,"description":"At most this many hits; 10 when absent."}},"required":["query"],"additionalProperties":false},"annotations":{"title":"Search codes and terms","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"9438625fab73f6a471257350a545264d18105dba46db2c0f0b4b84c715fc9e9b","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T06:46:36.630Z","metadataTrust":"untrusted"},{"serverName":"com.postalref/postalref","endpointFingerprint":"d75df41373326013ccdff281549373d44a89ab158ce5e7cc2bd224e5e05c5502","name":"search_documents","title":"Search PostalPro documents","description":"Search every document on PostalPro by title and file name, with its page and newest file, and the product pages and downloads postalref holds by title. Each one postalref holds the text of carries an `id`, which read_source takes as `document`. A title says only that USPS publishes a document: read one it lists with read_source to learn what it says.","inputSchema":{"type":"object","properties":{"query":{"type":"string","maxLength":120,"description":"Words from a document's title or file name."},"topic":{"type":"string","enum":["mailing","shipping","address-quality","visibility","promotions","operations","accounts","industry","international","other"],"description":"Only documents a model put under this topic."},"limit":{"type":"integer","minimum":1,"maximum":50,"description":"At most this many; 10 when absent."}},"required":["query"],"additionalProperties":false},"annotations":{"title":"Search PostalPro documents","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"e727aee8f1b8a60a0fb7976f61fcdebb44065a68b57aac1edf1c675fa82e6644","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T06:46:36.630Z","metadataTrust":"untrusted"},{"serverName":"com.postalref/postalref","endpointFingerprint":"d75df41373326013ccdff281549373d44a89ab158ce5e7cc2bd224e5e05c5502","name":"search_text","title":"Search the text of documents","description":"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: search again with its id as `document` 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 id and page read_source 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. 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 give them to read_source as `document` and `page` for the sentences around it. When no hit answers, search again with the words an answer would say.","inputSchema":{"type":"object","properties":{"query":{"type":"string","maxLength":200,"description":"Words a page says: a price, a rule, a size, a name. Each word is found in its forms: one or many, -ed, -ing, -able, -ous."},"limit":{"type":"integer","minimum":1,"maximum":40,"description":"At most this many pages; 10 when absent."},"document":{"type":"string","description":"Only this document's pages, by the id a hit or search_documents gives: every page of it that says the words, up to `limit`. Every held document when absent."}},"required":["query"],"additionalProperties":false},"annotations":{"title":"Search the text of documents","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"6baf04c14f3988a03a92cd243f68ee1a7fe988ebfefbed848931d4fadd715b9b","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T06:46:36.630Z","metadataTrust":"untrusted"}],"endpoints":[{"endpointFingerprint":"d75df41373326013ccdff281549373d44a89ab158ce5e7cc2bd224e5e05c5502","protocol":"streamable-http","status":"indexed","toolCount":8,"observedAt":"2026-11-19T06:46:36.630Z"}],"authentication":"unknown"},"connectionConfigurations":{"status":"ready","authentication":"not embedded","clients":{"Claude Desktop":{"mcpServers":{"com.postalref/postalref":{"url":"https://postalref.com/mcp"}}},"Cursor":{"mcpServers":{"com.postalref/postalref":{"url":"https://postalref.com/mcp"}}},"VS Code":{"servers":{"com.postalref/postalref":{"type":"http","url":"https://postalref.com/mcp"}}}}},"resourceType":"mcp-server","callable":true,"runtime":{"callable":true,"protocols":["mcp"]},"interfaces":[{"protocol":"mcp","transport":"streamable-http","url":"https://postalref.com/mcp"}],"profile":{"apiVersion":"1","schemaVersion":"1","id":"mcp-server:com.postalref%2Fpostalref","resourceType":"mcp-server","canonicalUrl":"https://www.agentsjunction.com/api/v1/servers/com.postalref%2Fpostalref","name":"com.postalref/postalref","description":"USPS package barcodes, service type codes and mailing terms, each cited to its USPS source.","interfaces":[{"protocol":"mcp","transport":"streamable-http","url":"https://postalref.com/mcp"}],"capabilities":[],"identity":{"source":"official-registry","websiteUrl":"https://postalref.com","repositoryUrl":null,"version":"0.3.0"},"verification":{"state":"official","confidence":100},"operations":{"resourceType":"mcp-server","name":"com.postalref/postalref","status":"online","lastCheckedAt":"2026-11-20T07:17:46.016Z","lastSuccessfulCheck":"2026-11-20T07:17:46.016Z","latencyMs":1550,"consecutiveFailures":0,"isStale":false,"checks":{"endpointReachable":true,"protocolValid":true,"agentCardValid":null,"mcpHandshakeValid":true},"lastSeen":null,"lastSuccessfulInteraction":null,"lastHealthCheck":"2026-11-20T07:17:46.016Z","source":{"type":"health-check","url":null},"observedAt":"2026-11-20T07:17:46.016Z"},"security":null,"timestamps":{"createdAt":"2026-11-19T20:01:19.179Z","updatedAt":"2026-11-19T20:01:19.179Z","observedAt":"2026-11-20T07:17:46.016Z"},"compatibility":{"serverVersion":"0.3.0","protocolVersions":[{"protocol":"mcp","version":null}]}}}}