UA

    USPS Addresses API v3 Client (post-Web-Tools)

    1

    USPS retired its legacy Web Tools (the USERID XML APIs) in January 2026; anything still calling them for address validation stopped working.

    $29

    Secure checkout via Stripe

    Money-back guarantee

    Converts to your local currency at checkout

    Security scanned

    Works with the AI Agents you already use

    Claude CodeClaude CodeCursorCursorCodex CLICodex CLIDeepSeekDeepSeekMuseMuse+22 more

    About this skill

    USPS retired its legacy Web Tools (the USERID XML APIs) in January 2026; anything still calling them for address validation stopped working. The replacement platform uses OAuth 2.0 client credentials and JSON, and most integrations have not been ported.

    Client (usps-addresses.mjs): createUspsClient({ clientId, clientSecret, baseUrl }) with configured() so "not configured" is a first-class state (USPS_NOT_CONFIGURED before any network call, never a pretend success); a client-credentials token cached until 60 seconds before expiry and dropped on a 401; validateAddress returning standardized lines, ZIP5 and ZIP+4, a routingCode for an Intelligent Mail barcode (9 digits, never a fabricated delivery point; the delivery point and carrier route are reported separately when USPS returns them), the DPV confirmation code and its meaning in words (deliverable, unit missing, unit mismatch, not found), business and vacant flags, corrections and matches; cityState(zip) and zipCode(address) lookups; errors with codes (USPS_AUTH_FAILED, USPS_ADDRESS_NOT_FOUND, USPS_ADDRESS_FAILED, USPS_ZIP_NOT_FOUND, USPS_LOOKUP_FAILED, USPS_INVALID_REQUEST). Production and sandbox base URLs; fetch injectable.

    CLI (usps-cli.mjs): validate, city-state and zip with credentials from a file (never argv), --sandbox, exit 3 when unconfigured.

    5 tests against a loopback fake of the token and Addresses endpoints: unconfigured paths make no call; one token for several calls, refresh after expiry, wrong secret; standardization, ZIP+4, DPV meanings, five-digit ZIP in the query, not-found and server-error codes; lookups; CLI exit codes. Node 18+, no packages; network only to the USPS hosts with your credentials.

    Find more skills like this on the Claude Skills Marketplace, the Codex Skills Marketplace and the Gemini Skills Marketplace, or browse All Claude Skills.

    How to use

    1. 1

      Connect your agent to the Agensi MCP

      Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup

    2. 2

      Sign in to Agensi

      Your agent shows a sign-in link. Sign in and click Allow.

    3. 3

      Ask for what you need

      Your agent loads this skill and uses it on your task. It always asks before buying a skill.

    Reviews

    No reviews yet

    Be one of the first to try it. Every listed skill goes through the trust checks below.

    Security scanned

    Checked by our 8-point scan before listing

    Fresh listing

    Recently published to Agensi

    Money-back guarantee

    Doesn't do what its page promises? You get your money back.

    Trust & safety

    Security scan

    Security scan passed 17 days ago

    Software
    Node.js 18+

    Permissions

    Read Files
    Network Access
    Listed17 days ago

    What's inside

    Frequently Asked Questions

    Validate and standardize US addresses on the current USPS APIs platform, not the Web Tools retired in 2026: OAuth client credentials with token cache, ZIP+4, DPV deliverability in plain words, a 9-digit Intelligent Mail routing code (no fabricated delivery point), city/state and ZIP lookups

    This skill uses the open SKILL.md standard. Use it through an MCP-compatible agent connected to Agensi, and check the compatibility information on this page for confirmed agents and required capabilities.

    Connect your AI agent to Agensi through MCP, then ask it to use USPS Addresses API v3 Client (post-Web-Tools) on your task. Your agent loads the latest approved version each time. Paid skills require a purchase or active subscription. Skill files are not available for download; your licence does not allow you to save, copy or export any part of a skill.