USPS Web Tools Connector for AI agents.
8 live capabilities
Verify shipping addresses and track packages with official USPS data.
Waiting for input…
Why people use USPS Web Tools
USPS Developer Portal for Accurate Shipping Logistics
With this Connector, you just tell your agent to verify the address and pull the rate in one go. You get a confirmed, standardized address and a price quote instantly in your chat window.
What Vinkius changes
You get a direct connection to official postal data without ever leaving your AI chat interface.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 6,100+ Connectors
- Real-world use case 01
Reducing Return Rates
A store owner sees a high return rate.
- Real-world use case 02
International Pricing
A seller needs to price a bulk order.
- Real-world use case 03
Deep Tracking Analysis
A customer service rep asks the agent to use track_usps_package_advanced to see why a package has been stuck at a specific hub for three days.
Complete set · 8capabilities
The complete USPS Web Tools capability set.
These are the exact actions your AI can choose when you ask it to work with USPS Web Tools.
01—04
4 capabilities in this set.
Part of 8 available through USPS Web Tools.
- 01 Capability
Lookup usps zip code
Find the exact ZIP code for a specific United States street address. This prevents errors on shipping labels.
- 02 Capability
Verify usps address
Standardize and confirm a US address against official USPS records. This removes the risk of manual entry errors.
- 03 Capability
Lookup usps city state
Get the city and state for any specific ZIP code. This helps you map out regional logistics quickly.
- 04 Capability
Track usps package advanced
Get deep tracking details including specific facility-level events. This is useful for pinpointing stuck packages.
05—08
4 capabilities in this set.
Part of 8 available through USPS Web Tools.
- 05 Capability
Track usps package
Check the current status of a package using a standard tracking number. This gives you a quick look at where a parcel is.
- 06 Capability
Calculate domestic rate
Get current USPS domestic shipping costs based on your mail needs. This ensures your shipping budget stays accurate.
- 07 Capability
Calculate international rate
Find out how much it costs to ship packages to global destinations. Use this to give customers accurate quotes.
- 08 Capability
Get delivery commitments
See current USPS delivery estimates and time commitments for different mail classes. Use this to manage customer expectations.
Set up in minutes
One URL. Then ask USPS Web Tools to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use USPS Web Tools from the conversation.
Choose your client
Live previewAdvanced clients IDE · CLI
Claude · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_R7DQnUcS3k7mzjKxMrsMbzxWu6CJTEhHjGrbKAVt/mcp - Step 01
Open Connectors
In Claude Web or Claude Desktop, open Settings and choose Connectors.
- Step 02
Add the URL
Choose Add custom connector, name it USPS Web Tools, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable USPS Web Tools for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_R7DQnUcS3k7mzjKxMrsMbzxWu6CJTEhHjGrbKAVt/mcp - Step 01
Open MCP settings
On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
- Step 02
Add the URL
Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the USPS Web Tools URL.
- Step 03
Save and start
Save the connection and enable USPS Web Tools in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"usps-developer-portal": {
"url": "https://edge.vinkius.com/vk_preview_R7DQnUcS3k7mzjKxMrsMbzxWu6CJTEhHjGrbKAVt/mcp"
}
}
}- Step 01
Open MCP Settings
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
- Step 02
Add the server config
Paste the JSON configuration above into the mcp.json file that opens
- Step 03
Save the file
Cursor will automatically detect the new Connector
- Step 04
Start using USPS Web Tools
Open Agent mode in chat and ask: "Using USPS Web Tools, help me...". 8 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"usps-developer-portal": {
"url": "https://edge.vinkius.com/vk_preview_R7DQnUcS3k7mzjKxMrsMbzxWu6CJTEhHjGrbKAVt/mcp"
}
}
}- Step 01
Create MCP config
Create a .vscode/mcp.json file in your project root
- Step 02
Add the server config
Paste the JSON configuration above
- Step 03
Enable Agent mode
Open GitHub Copilot Chat and switch to Agent mode using the dropdown
- Step 04
Start using USPS Web Tools
Ask Copilot: "Using USPS Web Tools, help me...". 8 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"usps-developer-portal": {
"url": "https://edge.vinkius.com/vk_preview_R7DQnUcS3k7mzjKxMrsMbzxWu6CJTEhHjGrbKAVt/mcp"
}
}
}- Step 01
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
- Step 02
Add the server
Paste the JSON configuration above into mcp_config.json
- Step 03
Save and reload
Windsurf will detect the new server automatically
- Step 04
Start using USPS Web Tools
Open Cascade and ask: "Using USPS Web Tools, help me...". 8 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"usps-developer-portal": {
"url": "https://edge.vinkius.com/vk_preview_R7DQnUcS3k7mzjKxMrsMbzxWu6CJTEhHjGrbKAVt/mcp"
}
}
}- Step 01
Open Cline MCP Settings
Click the Connectors icon in the Cline sidebar panel
- Step 02
Add remote server
Click "Add Connector" and paste the configuration above
- Step 03
Enable the server
Toggle the server switch to ON
- Step 04
Start using USPS Web Tools
Ask Cline: "Using USPS Web Tools, help me...". 8 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add usps-developer-portal --transport http "https://edge.vinkius.com/vk_preview_R7DQnUcS3k7mzjKxMrsMbzxWu6CJTEhHjGrbKAVt/mcp"- Step 01
Install Claude Code
Run npm install -g @anthropic-ai/claude-code if not already installed
- Step 02
Add the Connector
Run the command above in your terminal
- Step 03
Verify the connection
Run claude mcp to list connected servers, or type /mcp inside a session
- Step 04
Start using USPS Web Tools
Ask Claude: "Using USPS Web Tools, show me...". 8 tools are ready
Where the request belongs
Work USPS Web Tools can move forward.
This is for anyone who handles high-volume shipping or logistics. If you're tired of manual data entry into shipping software or dealing with undeliverable addresses, this is for you.
Logistics Manager
Monitors package timelines and pulls official metadata to keep the supply chain moving.
E-commerce Lead
Verifies customer addresses at checkout to reduce return rates and failed deliveries.
Operations Lead
Automates the pulling of shipping rates and ZIP code metadata for regional audits.
Address Researcher
Quickly maps out geographic data and ZIP code markers for market analysis.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsEasyPost
Equip your AI agent to manage shipments, track packages, and monitor carrier accounts via the EasyPost API.
Lob
Send physical mail programmatically with an API for postcards, letters, and checks that integrates into your digital workflows.
Click2Mail
Manage physical mail and printing via Click2Mail. track jobs, monitor credit balance, and submit mailings directly from any AI agent.
UK Postbox
Manage your virtual mailbox via UK Postbox u2014 scan letters, forward mail, send correspondence, and track parcels from your AI agent.
ShipEngine
Compare shipping rates, print labels, and track packages across UPS, FedEx, USPS, and dozens of global carriers instantly.
Correios do Brazil
Calculate shipping costs, estimate delivery times, and consult address information via the official Correios REST API.
Bring your own AI
Change the model, client or framework. Keep USPS Web Tools connected.
-
Claude -
ChatGPT -
Gemini -
Cursor -
VS Code -
Windsurf -
ZCode -
Cline -
Zed -
Continue -
Kiro -
Roo Code -
Zencoder -
Goose -
Void -
Augment Code -
Amp -
Qodo -
Tabnine -
Pieces -
Sourcegraph Cody -
JetBrains -
Warp -
Amazon Q -
Antigravity -
BoltAI -
Raycast -
Jan -
LM Studio -
AnythingLLM -
Open WebUI -
Msty -
Cherry Studio -
LibreChat -
TypingMind -
Chorus -
5ire -
n8n -
LangChain -
LlamaIndex -
CrewAI -
Vercel AI SDK
Before you connect
Questions about USPS Web Tools.
The practical details behind the request, access and result.
What does the USPS Developer Portal MCP do?
It connects your AI agent to official USPS data. You can use it to verify addresses, get shipping rates, and track packages without leaving your chat interface.
Can I use it to check international shipping costs?
Yes, the Connector can pull real-time international shipping rates based on the weight and destination you provide to your agent.
How does it help with address errors?
It standardizes addresses against official records. This helps you catch typos and ensure that your mail reaches the correct destination the first time.
Does it provide real-time tracking?
Yes, it pulls live tracking updates. It can even provide facility-level details to help you see exactly where a package is held up.
Can it tell me the city for a ZIP code?
Yes, your agent can look up the city and state for any US ZIP code instantly using this Connector.
Is this for commercial shipping?
It is designed for anyone needing official USPS data, including e-commerce leads, logistics managers, and operations teams.
How do I connect it to my agent?
Simply subscribe to the Connector on Vinkius and enter your USPS Web Capabilities User ID in your AI client settings.
How do I find my USPS User ID?
Register for an account at the USPS Web Capabilities registration page. You will receive your User ID via email. Copy and paste it below.
Does it support international tracking?
Yes. The track_usps_package capability supports tracking for any valid USPS tracking number, including international shipments originating from or delivered by USPS.
What is the format for address verification?
The API requires an object with line1, city, and state metadata. Standardizing these inputs ensures the most accurate verification from the USPS database.
One connection away
Give your agent a direct line to USPS Web Tools.
Connect USPS Web Tools once. Keep it beside 6,100+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available