# Haversine Distance Engine MCP > Haversine Distance Engine calculates precise geographic distances between any two GPS coordinates instantly. It uses spherical trigonometry, providing mathematically accurate distance measurements for logistics and field operations. Stop relying on rough estimates; get exact distances in kilometers, miles, or meters every time. ## Overview - **Category:** developer-tools - **Price:** Free - **Tags:** geospatial, spherical-trigonometry, distance-calculation, gps-data, mathematics ## Description When your AI agent needs to know the real distance between Point A and Point B, it can't hallucinate a straight-line guess. This MCP fixes that problem by giving your client access to proven geographic mathematics. Instead of guesswork, you get accurate results calculated using the Haversine formula, which accounts for the Earth's curved shape. You pass in two sets of latitude and longitude coordinates, and this connector returns the exact distance. It handles multiple units—you can get kilometers, miles, or meters without any manual conversion steps. All you need is a Vinkius subscription to connect it to your preferred AI client and start calculating trusted geo-metrics right away. ## Tools ### haversine_calculate_distance Calculates the exact geographic distance between two GPS coordinates using the mathematical Haversine formula. ## Prompt Examples **Prompt:** ``` Calculate the exact geographic distance in kilometers between London (51.5074, -0.1278) and Paris (48.8566, 2.3522). ``` **Response:** ``` ✅ **Calculation Complete:** The exact Haversine distance is `343.46` km. ``` **Prompt:** ``` What is the distance in miles from the warehouse (-23.5505, -46.6333) to the delivery address (-22.9068, -43.1729)? ``` **Response:** ``` ✅ **Result:** The spherical distance is `223.32` miles. ``` **Prompt:** ``` Convert the distance between these coordinates into exact meters for a micro-mobility agent. ``` **Response:** ``` ✅ **Geo Metrics:** The coordinates are exactly `1,250.45` meters apart. ``` ## Capabilities ### Calculate spherical distance Determines the precise geographic separation between two GPS points using complex trigonometric calculations. ### Multi-unit output Returns the calculated distance in multiple formats, including kilometers, miles, and meters. ## Use Cases ### Calculating cross-country shipping costs A logistics manager needs to estimate the cost between Dallas, Texas, and Chicago, Illinois. Instead of pulling up an unreliable Google Maps straight-line guess, they ask their agent to run haversine_calculate_distance with the coordinates. The MCP returns the true spherical distance in miles for billing purposes. ### Verifying site survey measurements A surveyor needs to know if two boundary markers are separated by exactly 125 meters, needing high fidelity. They prompt their agent with both sets of coordinates and the MCP uses haversine_calculate_distance, confirming the precise metric measurement for legal documentation. ### Optimizing local delivery routes A dispatcher needs to check if three different drop-off points are all within a 5 km radius of the depot. They use haversine_calculate_distance repeatedly, confirming that every point is within the required range before sending out the team. ### Comparing two historical data points A researcher needs to analyze how far apart two recorded event locations were on a specific date. They input both coordinate sets into haversine_calculate_distance, getting an accurate measurement that accounts for the Earth's shape. ## Benefits - Stop relying on estimated straight-line guesses. The haversine_calculate_distance tool uses proven math to give you the actual distance over the Earth's surface. - Handle multiple units instantly. You don't need separate calculations or conversions; the result comes back in kilometers, miles, and meters. - Speed matters. This MCP runs complex spherical trigonometry quickly enough for high-volume queries without slowing down your AI agent. - It guarantees mathematical precision. Use it for anything critical—from billing to route planning—where rounding errors cost money or time. - Simple input, reliable output. You only provide two sets of coordinates and get a single, trustworthy distance measurement. ## How It Works The bottom line is you feed it coordinates and get back guaranteed accurate physical distances. 1. Provide your AI client with two coordinate sets: latitude and longitude for Point 1, and latitude and longitude for Point 2. 2. The MCP executes the Haversine formula, running complex spherical trigonometry in milliseconds to account for Earth's curvature. 3. You get a single result showing the distance measured accurately across multiple units (km, miles, meters). ## Frequently Asked Questions **Does it calculate driving distance?** No, it calculates the 'as-the-crow-flies' spherical distance. **Is it local?** Yes, 100% local mathematical calculation. No API key required. **What units does it return?** Kilometers (km), Miles (mile), Meters (meter), and Nautical Miles (nmi). **What coordinate format should I use when running haversine_calculate_distance?** The tool requires standard pairs of latitude and longitude for both points. Ensure your inputs are floating-point numbers to maintain precision. You must provide four numerical arguments in the order: lat1, lon1, lat2, and lon2. **If I call haversine_calculate_distance with invalid coordinates, how does it handle errors?** The MCP includes built-in validation for geographical boundaries. If you pass coordinates outside the valid range (like latitude > 90), the tool returns a clear error message explaining the input failure. This prevents calculation crashes. **Is there a performance concern or rate limit when using haversine_calculate_distance?** The calculations are designed for high speed, executing complex spherical trigonometry instantly. Like all Vinkius MCPs, usage is governed by standard API rate limits, but the core calculation itself runs efficiently. **Do I need to write any specific code or setup to use haversine_calculate_distance?** No. Since this is an MCP, you simply invoke `haversine_calculate_distance` using natural language prompts in your AI client. Vinkius handles the connection and data passing automatically. **Why should I trust haversine_calculate_distance over simple straight-line formulas?** It uses the mathematically rigorous Haversine formula, which accounts for Earth's curvature. This means it calculates the distance along the surface of a sphere, yielding a much more accurate result than any flat-earth approximation.