Skip to main content
Glama

Look up a code

lookup
Read-onlyIdempotent

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.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "code": "<code>"
    },
    "name": "lookup"
  }
}

Input Schema

NameRequiredDescriptionDefault
codeYesA code as USPS prints it: 055, 920, PM, 01.
tableNoOne 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.

Output Schema

NameRequiredDescriptionDefault
matchesYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedInput schema / properties / table / description
      Previous value: -"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 or impb-tray-sack-barcode-constructs. Every table when absent."New value: +"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."
  2. Changed1 schema field changed
    • changedInput schema / properties / table / description
      Previous value: -"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 or impb-international-scan-events, impb-edi-event-codes. Every table when absent."New value: +"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 or impb-tray-sack-barcode-constructs. Every table when absent."
  3. Changed1 schema field changed
    • changedInput schema / properties / table / description
      Previous value: -"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 or impb-international-scan-events. Every table when absent."New value: +"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 or impb-international-scan-events, impb-edi-event-codes. Every table when absent."
  4. Changed1 schema field changed
    • changedInput schema / properties / table / description
      Previous value: -"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 or impb-cew-messages. Every table when absent."New value: +"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 or impb-international-scan-events. Every table when absent."
  5. Changed1 schema field changed
    • changedInput schema / properties / table / description
      Previous value: -"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 or maildat-client-info. Every table when absent."New value: +"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 or impb-cew-messages. Every table when absent."
  6. Changed1 schema field changed
    • changedInput schema / properties / table / description
      Previous value: -"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 or lacslink-return-codes. Every table when absent."New value: +"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 or maildat-client-info. Every table when absent."
  7. Changed1 schema field changed
    • changedInput schema / properties / table / description
      Previous value: -"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, dpv-return-codes, dpv-footnotes, ptr, ptr2, stid, opcodes, unexpected-opcodes, ncoalink-return-codes or ncoalink-return-code-matrix. Every table when absent."New value: +"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 or lacslink-return-codes. Every table when absent."
  8. Changed1 schema field changed
    • addedOutput schema / properties / matches / items / properties / rows / items / properties / notes
      Added value: +{
      +  "items": {
      +    "additionalProperties": true,
      +    "properties": {
      +      "mark": {
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "page": {
      +        "additionalProperties": true,
      +        "properties": {
      +          "pdf": {
      +            "maximum": 9007199254740991,
      +            "minimum": -9007199254740991,
      +            "type": "integer"
      +          },
      +          "printed": {
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "pdf"
      +        ],
      +        "type": "object"
      +      },
      +      "revision": {
      +        "type": "string"
      +      },
      +      "text": {
      +        "minLength": 1,
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "mark",
      +      "text",
      +      "revision",
      +      "page"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
  9. Changed1 schema field changed
    • changedInput schema / properties / table / description
      Previous value: -"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, ptr, ptr2, stid, opcodes, unexpected-opcodes, ncoalink-return-codes or ncoalink-return-code-matrix. Every table when absent."New value: +"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, dpv-return-codes, dpv-footnotes, ptr, ptr2, stid, opcodes, unexpected-opcodes, ncoalink-return-codes or ncoalink-return-code-matrix. Every table when absent."
  10. Changed1 schema field changed
    • changedInput schema / properties / table / description
      Previous value: -"One table to look in: stc, extra-services, mail-classes, ptr, ptr2 or stid. Every table when absent."New value: +"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, ptr, ptr2, stid, opcodes, unexpected-opcodes, ncoalink-return-codes or ncoalink-return-code-matrix. Every table when absent."
  11. First observed

TDQS

A3.7/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnly, idempotent, closed-world and non-destructive, so the safety profile is covered. The description adds genuine behavior beyond that: which edition is authoritative ('the newest edition that lists it'), that history and multiple listing editions are returned, and the normalization/fallback rules (marks stripped, multi-code rows, two digits also tried as three). It does not discuss rate limits or ambiguity reporting, keeping it short of a 5.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two sentences, front-loaded with the purpose and output shape, then the matching rules, with no filler. The second sentence is dense and jargon-heavy (passage/revision/page/cells), which costs a little readability, but every clause carries information.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a tool spanning dozens of tables with non-obvious code-matching semantics, the description supplies the matching rules and citation format that the schema cannot. Since an output schema exists, it need not detail return values, and it doesn't over-explain them. Only the missing when-to-use guidance against siblings leaves a small gap.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so both parameters are already documented and the baseline is 3. The description does add real meaning about how the `code` value is matched — marks ignored, multi-code rows, and the two-digit-to-three-digit fallback with ordering ('55 finds PTR's 55, then STC's 055') — but it says nothing about the `table` scoping parameter beyond what the schema enumerates.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description names a specific verb and resource ('Look up a USPS code') and then enumerates the exact payload: the newest edition's row, the codes its cells name, the editions that list it, history, and passage ids. That is far more concrete than a tautology and would let an agent distinguish it from siblings like decode or define, though no sibling is named explicitly.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Usage is implied by the opening verb, and the description usefully states acceptable input forms ('a code is found without the marks USPS prints around it', '750 finds *750'). However, there is no statement of when to prefer this over decode/define/search, and no prerequisites or exclusions, so the routing guidance is only implied.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources