postalref

com.postalrefPublished by postalref.comOfficial publisherv0.2.0Updated Nov 2, 2026

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

VerifiedStreamable HTTPWeb executableWeb Search & ScrapingKnowledge & Memory

Overview

AI-generated overview

Answers USPS mailing questions — package barcodes, service type codes, terms and PostalPro documents — each cited to its USPS source passage.

What you can do
  • Decode package barcodes and tracking numbers: field layout, digit meanings, check digit, service type code row
  • Look up USPS codes: printed row, related codes, editions and history
  • Compare a code table or document between two editions and rate each change
  • Search codes, terms, banner texts, specs and documents through one ranked index
  • Define USPS names and abbreviations with their registry entries and source pages
  • Read a modeled document revision page by page for exact quoting, and search all PostalPro documents by title and file name
When to use it
Useful when an assistant has to explain or verify USPS mailing details — interpreting a barcode, checking what a service type code means, tracking how a specification changed between editions, or quoting PostalPro text — and answers need to be traceable to the USPS source.
Requirements
A remote streamable HTTP endpoint at postalref.com; no package, environment variables or headers are declared. No authentication is declared.
Before you install
Answers are limited to the USPS documents postalref models, so codes or documents outside that set may not be found. Quoted text should be checked against the cited revision, page and passage before being relied on.

Installation

In SourceWeft

  1. Open postalref in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/com.postalref%2Fpostalref/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "postalref": {
      "type": "http",
      "url": "https://postalref.com/mcp"
    }
  }
}

Tools

7

decode

Decode a barcode

Read a package barcode or tracking number (IMpb): its layout, each field's digits and meaning, whether the check digit holds, and the service type code's row in the USPS list, each with the passage that says so.

Parametersbarcoderequired

lookup

Look up a code

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.

Parameterscoderequiredtable

diff

Compare two editions

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.

Parameterstocodefromlimitsubjectrequiredseverity

define

Define a USPS term

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.

Parametersnamerequiredlimit

read_source

Read a USPS document

Read a revision of a modeled USPS document page by page, as extracted, to quote it: a quote cites the revision's sha256, the PDF page and the words exactly.

Parametersfindpagepagesdocumentrequiredrevision

search_documents

Search PostalPro documents

Search every document on PostalPro by title and file name, with its page and newest file. postalref models a few of them; those carry a slug for read_source.

Parameterslimitqueryrequiredtopic

Version history

2
  1. v0.2.0LatestNov 2, 2026
  2. v0.1.0Oct 31, 2026

Score

72% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts

    Publish an icon in the registry entry.

  • Documentation15 pts

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • LicenseNot applicable

    A hosted service is used under its provider's terms, so no license is expected here. This check is left out of the percentage.