USPS Addresses API v3 Client (post-Web-Tools)
USPS retired its legacy Web Tools (the USERID XML APIs) in January 2026; anything still calling them for address validation stopped working.
$29
Works with the AI Agents you already use
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
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
Sign in to Agensi
Your agent shows a sign-in link. Sign in and click Allow.
- 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+