# Open-Meteo MCP

> Open-Meteo Geocoding & Elevation resolves any place name, city, or address into precise GPS coordinates. It gives you more than just latitude and longitude; it returns population density, time zone data, postal codes, and high-accuracy terrain elevation (up to 90m precision). This is the essential layer for building location-aware applications that require deep geographic context.

## Overview
- **Category:** data-management
- **Price:** Free
- **Tags:** location-services, gps-coordinates, elevation-data, timezone-lookup, spatial-data

## Description

If your application needs to know exactly where something is—and what's happening at that spot—this MCP handles it. You stop guessing or relying on generalized maps. Instead, you can feed any city name, from anywhere in the world and in any language, into this system and get a full data packet back. This includes precise coordinates, whether the location has a specific time zone, population counts, and postal codes.

For example, if you're building a travel app or a logistics tracker, knowing just the name 'Boston' isn't enough. You need to know its exact elevation profile, which is exactly what this MCP gives you. It lets your agent determine terrain elevation for any given coordinate pair using detailed digital models. Because Vinkius hosts and manages this entire catalog of location services, connecting it means your agent gains reliable access to global spatial data right where it needs it.

It’s the foundational toolset that takes a vague concept—like 'the mountain near Denver'—and turns it into actionable coordinates with elevation metrics.

## Tools

### search_location
Search for any city or place globally, supporting multiple languages and returning coordinates.

### get_elevation
Retrieve the specific terrain elevation in meters for a given set of latitude and longitude coordinates.

### search_location_by_country
Search for locations, filtering results only to those within a specified country using its ISO code.

## Prompt Examples

**Prompt:** 
```
Where exactly is Machu Picchu? Give me coordinates and elevation.
```

**Response:** 
```
📍 **Machu Picchu**

Latitude: -13.1631
Longitude: -72.5450
Elevation: 2,430m above sea level
Timezone: America/Lima (UTC-5)
Country: Peru 🇵🇪
Admin region: Cusco
```

**Prompt:** 
```
Find all cities named 'Springfield' in the United States
```

**Response:** 
```
🏘️ **Springfield — US Results**

1. Springfield, IL — Pop: 114,394 (39.80°N, 89.64°W)
2. Springfield, MO — Pop: 169,176 (37.22°N, 93.29°W)
3. Springfield, MA — Pop: 155,929 (42.10°N, 72.59°W)
4. Springfield, OH — Pop: 58,662
5. Springfield, OR — Pop: 62,979

10 results found across 10 different states.
```

**Prompt:** 
```
What's the elevation of Mount Kilimanjaro's summit?
```

**Response:** 
```
🏔️ **Mount Kilimanjaro — Uhuru Peak**

Elevation: 5,895m (19,341 ft)
Coordinates: -3.0674°S, 37.3556°E
Country: Tanzania 🇹🇿

Highest point in Africa and the tallest free-standing mountain in the world.
```

## Capabilities

### Find locations globally
You can search for any city or village by name, regardless of the language used, receiving full location details like population and time zone.

### Filter searches by country
The system restricts your searches to specific countries using their ISO codes, narrowing down results quickly.

### Calculate terrain height
You obtain the precise elevation in meters for any set of GPS coordinates based on a 90-meter digital model.

## Use Cases

### Planning an international supply route
A logistics manager needs to check the altitude of three different checkpoints along a new railway line. The agent uses get_elevation on each checkpoint's coordinates, providing immediate operational feasibility data.

### Building a global directory app
A developer wants to list all major historical sites in France. They use search_location_by_country with the ISO code 'FR' and then use search_location to find specific regional centers, gathering populating data for each.

### Writing a travel itinerary generator
A user asks for details on an obscure village in Latin America. The agent uses search_location, which handles the non-English name and returns coordinates, time zone information, and population metrics needed to build the full trip plan.

### Validating database records
A data team uploads a spreadsheet of addresses. The agent systematically runs search_location on every address to validate if it's a real place and automatically retrieves its standardized coordinates, reducing manual data cleanup time.

## Benefits

- Get complete location context. Instead of just knowing a city's name, you get population data, time zones, postal codes, and precise coordinates using the search_location tool.
- Calculate terrain height instantly. You can use the get_elevation function to determine the exact altitude for any known GPS point without complex modeling.
- Build targeted searches. The search_location_by_country tool lets you filter out noise, ensuring your agent only looks at locations within a specific country’s borders.
- Improve data quality across languages. Since the search_location function supports multiple languages, you don't have to worry about translating place names before processing them.
- Future-proof your location services. This MCP provides foundational spatial data—coordinates and elevation—that works as a reliable companion for any weather or mapping tool.

## How It Works

The bottom line is that you get clean, structured geographic data without having to write complex API calls or manage multiple lookup services.

1. Your agent first requests location data, providing either a place name or a list of known country codes.
2. The MCP processes the request across its internal databases to resolve the specific geographical details and coordinates for the area in question.
3. You receive a structured JSON output containing latitude, longitude, population metrics, time zone info, and—if requested—the terrain elevation.

## Frequently Asked Questions

**How does Open-Meteo Geocoding & Elevation handle non-English place names?**
It supports any language. The search_location tool resolves global city and village names regardless of the language they are written in, giving you standardized coordinates.

**Can I use Open-Meteo Geocoding & Elevation to find elevation?**
Yes, absolutely. Use get_elevation by providing any set of GPS coordinates; it returns the precise terrain height in meters using a 90m digital model.

**What if I only have a country code and no city name?**
You can start with search_location_by_country. This tool filters all possible results to that specific ISO country, narrowing your scope before you try searching for a particular location.

**Does Open-Meteo Geocoding & Elevation provide time zone data?**
Yes, the search_location function includes timezone information for resolved locations. This is critical for scheduling and multi-region operations.

**Is this MCP better than using Google Maps API for location data?**
This MCP excels because it bundles elevation (get_elevation) with metadata like population and timezone, which many general mapping APIs treat as separate services. It provides a richer data set out of the box.