Skip to main content
Glama

Server Details

USPS package barcodes, service type codes and mailing terms, each cited to its USPS source.

If you are the author of this connector, you can claim ownership. Claimed connector authors can inspect health checks, view analytics, and manage their listing.
Status
Healthy
Uptime
100.0% over the last 24 hours
Last Tested
Transport
Streamable HTTP · MCP 2025-11-25
URL
ChatGPT
–
Claude
–

TDQS

A3.9/5.0

Scored across 6 tools

Disambiguation3/5

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.

Naming Consistency5/5

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.

Tool Count5/5

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.

Completeness4/5

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 tools
decodeDecode a barcodeA
Read-onlyIdempotent
Inspect

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 editionsA
Read-onlyIdempotent
Inspect

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 documentsA
Read-onlyIdempotent
Inspect

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 codeA
Read-onlyIdempotent
Inspect

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.comA
Read-onlyIdempotent
Inspect

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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Live 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.
      10
      1
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Global 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.
      4
      1
      MIT
    Try in Browser

    Glama MCP Gateway

    Add one secure layer between your agents and this server.

    Resources