# ZIP Codes API MCP > ZIP Codes API lets your AI client audit location data across US and Canadian ZIP codes. Need to find all addresses within a 10-mile radius? Calculate the exact distance between two locations, or pull demographic details for any specific postal code? This MCP gives you precise geographic intelligence right where you need it. ## Overview - **Category:** data-management - **Price:** Free - **Tags:** geographic-data, radius-search, distance-calculation, location-metadata, logistics-optimization, address-validation ## Description Stop guessing about where things are located. This MCP lets your agent treat complex location auditing like a simple conversation. Whether you're doing market research across state lines or optimizing regional delivery routes, you don't need to open a dozen tabs and cross-reference spreadsheets. You just ask the question—like, 'What ZIP codes surround this county?'—and get verified, detailed data back immediately. It pulls everything from finding all related locations in a specific city, calculating precise distances between any two points, or even identifying all addresses within a certain mileage radius of your starting point. When you connect this to Vinkius, you bring professional-grade geographic consulting right into your chat window, making sure every piece of location data is accurate and immediately actionable. ## Tools ### find_zips_by_city Looks up all associated postal codes given a specific city and state name. ### find_zips_by_county Retrieves every ZIP code located within a specified county boundary. ### find_zips_by_state Lists all available postal codes for an entire state. ### get_zip_distance Calculates and returns the precise distance in miles between two specific ZIP codes. ### find_zips_in_radius Identifies all ZIP codes that fall within a specified mile radius of a starting postal code. ### get_zip_details Pulls comprehensive geographic and demographic data for one specific, single ZIP code. ## Prompt Examples **Prompt:** ``` Get details for ZIP code '90210' using ZIP Codes API. ``` **Response:** ``` I've retrieved the details for 90210! It corresponds to Beverly Hills, California. It is located in Los Angeles County. Would you like the geographic coordinates or other ZIP codes in this city? ``` **Prompt:** ``` Find all ZIP codes within a 10 mile radius of '10001' (New York). ``` **Response:** ``` I've identified 50+ ZIP codes within a 10 mile radius of 10001. Notable areas include parts of Manhattan, Brooklyn, and Jersey City. I can provide the distance from the starting point for each if you'd like. ``` **Prompt:** ``` Calculate the distance between '10001' and '90210'. ``` **Response:** ``` The distance between New York (10001) and Beverly Hills (90210) is approximately 2,445 miles. I can assist you with more distance auditing if needed. ``` ## Capabilities ### Determine ZIP codes by region Finds all associated postal codes based on a given city name, county boundary, or state. ### Calculate location distance Provides the precise mileage calculation between any two specified ZIP codes. ### Identify nearby addresses Searches and lists all relevant ZIP codes within a specific mile radius of a starting point. ### Get deep location details Retrieves comprehensive geographic, demographic, and metadata information for one single ZIP code. ## Use Cases ### Determining Service Area Boundaries A regional sales manager needs to know if a new client address is within their current service zone. They ask the agent to 'find_zips_in_radius' around the target location, immediately confirming coverage without consulting a map or calling an analyst. ### Optimizing Delivery Routes A logistics coordinator needs to estimate total travel distance for two far-flung warehouses. They use 'get_zip_distance' with the two starting ZIP codes, getting the precise mileage needed for fuel budgeting and scheduling. ### Analyzing Local Market Density A market researcher is looking at a specific county to see potential retail locations. They use 'find_zips_by_county' to gather a complete list of all available ZIP codes in that area for deep demographic analysis. ### Validating Lead Locations An operations lead receives a batch of leads from a new state. They use 'find_zips_by_state' to ensure they capture all relevant postal code data before passing the list to the sales team. ## Benefits - Eliminate manual lookups. Instead of opening multiple tabs to find nearby zones, using 'find_zips_in_radius' instantly identifies all ZIP codes within a set mileage from any starting point. - Achieve perfect accuracy for planning. Calculating the exact distance between two locations with 'get_zip_distance' eliminates guesswork when optimizing routes or estimating travel time. - Deepen your research quickly. With 'get_zip_details', you pull rich metadata, including county and state information, for any given ZIP code in a single query. - Map out regional opportunities effortlessly. Need to know what's available? Use 'find_zips_by_county' or 'find_zips_by_city' to get a complete list of addresses associated with a defined area. - Keep your data organized by scope. Whether you need all ZIP codes for an entire state ('find_zips_by_state') or just those tied to one county, the right tool gets you there instantly. ## How It Works The bottom line is you talk to it naturally, and it handles all the complex database lookups for location intelligence. 1. Subscribe to this MCP and enter your required Zip-codes.com API Key. 2. Connect the MCP to your preferred AI client (Claude, Cursor, etc.). 3. Ask your agent a location question, like 'What is the distance between X and Y ZIP codes?' and receive verified data. ## Frequently Asked Questions **How do I find all associated postal codes for a specific county using ZIP Codes API?** You use the 'find_zips_by_county' tool. Just provide the name of the county, and the MCP will return every single ZIP code registered in that boundary. **Can I calculate distance between two points with ZIP Codes API?** Yes, you use 'get_zip_distance'. You simply feed it the two ZIP codes, and it returns the precise mileage between them. **Does this MCP handle international locations?** No. This API is specialized for United States and Canadian ZIP code data only. It won't work with addresses from other countries. **How do I check what’s within a 10-mile radius of my office using ZIP Codes API?** You use 'find_zips_in_radius'. You provide your starting ZIP code and the specific mile radius (e.g., 10), and it lists all related addresses. **What kind of data do I get when using get_zip_details?** You get comprehensive details, including city names, state information, county boundaries, latitude, and longitude coordinates for that specific ZIP code.