# ZIP Codes API MCP for AI Agents AI Agent Connect > ZIP Codes API MCP lets your AI agent handle geographic research, distance auditing, and regional mapping for US and Canadian locations. It pulls real-time data on cities, counties, and ZIP code clusters to help with logistics, market analysis, and sales territory planning. ## Overview - **Category:** data-management - **Price:** Free - **Endpoint:** https://edge.vinkius.com/undefined/ai-agent-connect - **Tags:** geographic-data, radius-search, distance-calculation, location-metadata, logistics-optimization, address-validation ## Description Instead of jumping between multiple tabs and manual search engines to find out where a specific ZIP code is located or how far it is from a warehouse, this Connector gives your AI agent the direct line it needs to geographic data. It turns your agent into a research assistant that knows the layout of the US and Canada. You can ask it to group ZIP codes by state or county, find every code within a specific mile radius of a starting point, or get the exact coordinates for a neighborhood. It takes the guesswork out of regional planning by providing verified data points in a single conversation. When you connect this to your workflow through the Vinkius catalog, your agent stops guessing and starts providing accurate geographic intelligence. It handles the heavy lifting of data retrieval so you can focus on making decisions about your logistics or market expansion. ## Tools ### find_zips_by_city List every ZIP code associated with a specific city and state. This helps group data by urban centers. ### find_zips_by_county Find all ZIP codes within a specific county. Use this to manage regional logistics or local government boundaries. ### find_zips_by_state Find every ZIP code in a specific state. This helps when you need to see the full geographic spread of a region. ### get_zip_distance Calculate the exact mileage between two ZIP codes. Use this to plan delivery routes or shipping costs. ### find_zips_in_radius Identify all ZIP codes within a set mile radius of a starting point. This is perfect for finding nearby competitors or customers. ### get_zip_details Pull geographic and demographic info for a specific ZIP code. It gives you the city, state, and county in one go. ## Prompt Examples **Prompt:** ``` I need to know how far it is from 90210 to 10001. ``` **Response:** ``` The distance between Beverly Hills (90210) and New York (10001) is approximately **2,445 miles**. Would you like me to find other nearby ZIP codes or check the distance to a different location? ``` **Prompt:** ``` Find all the ZIP codes in Cook County. ``` **Response:** ``` I've pulled the ZIP codes for **Cook County**. Here is the list of associated codes: * 60601 * 60605 * 60610 * 60611 * 60612 * ... (and 100+ more) Would you like me to filter these by a specific city? ``` **Prompt:** ``` What's in ZIP code 60601? ``` **Response:** ``` Here are the details for **60601**: * **City:** Chicago * **State:** Illinois * **County:** Cook * **Coordinates:** 41.8814° N, 87.6311° W Do you need any other information for this area? ``` ## Capabilities ### Get city and state details Pull geographic and demographic info for a specific ZIP code instantly. ### Identify regional clusters Find all ZIP codes within a specific mile radius of any starting point. ### Calculate shipping mileage Get the exact distance between two different ZIP codes for logistics planning. ### Map county boundaries Retrieve all ZIP codes associated with a specific county or state. ### Extract map coordinates Get latitude and longitude for specific codes to use in mapping software. ### Filter by urban centers List every ZIP code associated with a specific city and state. ## Use Cases ### Logistics route planning A manager asks for the distance between two warehouses to see if a new route is viable using get_zip_distance. ### Market research A researcher wants to find all ZIP codes in a 10-mile radius of a new retail site using find_zips_in_radius. ### Sales territory mapping A sales lead wants to see all ZIP codes in a specific county to assign leads to a team using find_zips_by_county. ### Data validation An ops lead needs to verify the city and county for a list of different ZIP codes using get_zip_details. ## Benefits - Stop manual searching: Use get_zip_details to get city and state data instantly without opening a browser. - Accurate logistics: Use get_zip_distance to get real mileage for shipping quotes instead of estimating. - Regional mapping: Use find_zips_in_radius to identify all nearby ZIP codes for targeted marketing. - Faster audits: Use find_zips_by_county to quickly pull all codes in a specific area for sales reports. - Coordinate retrieval: Use get_zip_details to get latitude and longitude for your internal mapping software. - State-wide views: Use find_zips_by_state to see the full footprint of a territory in one command. ## How It Works The bottom line is your agent gets instant access to verified US and Canadian geographic data. 1. Subscribe to the Connector and grab your Zip-codes.com API key. 2. Plug the key into your AI client's configuration. 3. Ask your agent to perform geographic lookups or distance audits. ## Frequently Asked Questions **Can the ZIP Codes API MCP find codes near my store?** Yes, you can ask your agent to identify every ZIP code within a specific mile radius of any starting point. This is great for seeing which neighborhoods are nearby. **How does the ZIP Codes API MCP calculate distances?** The Connector provides the exact mileage between any two ZIP codes. It's perfect for logistics planning and getting accurate shipping estimates. **Can I use the ZIP Codes API MCP for Canadian addresses?** Yes, this Connector provides authoritative geographic data for both the United States and Canada. **Does the ZIP Codes API MCP provide county information?** It does. You can retrieve the county associated with a specific ZIP code or find all ZIP codes that belong to a specific county. **How do I get the coordinates for a ZIP code using the ZIP Codes API MCP?** Your agent can retrieve the exact latitude and longitude for any given ZIP code, which is helpful for mapping and spatial analysis. **How do I find my Zip-codes.com API Key?** Log in to your [**Zip-codes.com account**](https://www.zip-codes.com/account/login.asp), and you will find your API Key under the 'API Settings' or 'My Account' section. Copy and paste it below. **Does it support Canadian postal codes?** Yes. Zip-codes.com provides extensive data for both United States ZIP codes and Canadian Postal Codes (forward sortation areas). **Can the agent calculate distances?** Yes. The `get_zip_distance` tool calculates the point-to-point distance in miles between any two valid ZIP codes instantly.