# IPGeolocation MCP

> IPGeolocation provides deep global intelligence by resolving IP addresses and coordinates into precise location data, time zones, and local culture details. Your agent gets accurate GPS coordinates, ISP information, current local times with UTC offsets, financial currency symbols, and astronomical metrics like sunrise/sunset timings for any point on Earth.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Tags:** geolocation, ip-intelligence, timezone-data, astronomy-data, network-audit, localization

## Description

You've got an application that needs to know where a user is—not just a city name, but the precise time they live in, what currency they use, and even if it's currently daylight saving time. This MCP connects your AI client directly to IPGeolocation’s full intelligence suite. Instead of hitting separate APIs for location, network data, and timezones, you ask your agent one question: 'What is happening at this IP?' The result is a single, rich payload containing everything from GPS coordinates and ISP details to local currency symbols and planetary metrics like moon phases. Using Vinkius means you connect once and suddenly gain access to this entire global knowledge base through natural conversation. This lets developers build highly localized experiences and security teams conduct rapid network audits without leaving their chat interface.

## Tools

### get_location
Retrieves detailed geographic information, including GPS coordinates, for a given IP address.

### get_timezone
Provides the precise local time, UTC offset, and daylight saving status for any specified region or coordinate set.

### get_astronomy
Accesses astronomical data for a location, such as sunrise times, sunset times, and moon phases.

## Prompt Examples

**Prompt:** 
```
Resolve the location for IP address '8.8.8.8'
```

**Response:** 
```
Resolving IP '8.8.8.8'… This address is located in Mountain View, California, United States. It belongs to the 'Google LLC' ISP. GPS Coordinates: 37.4223, -122.0841. Local currency is USD ($).
```

**Prompt:** 
```
What is the current local time and UTC offset in Tokyo?
```

**Response:** 
```
Current local time in Tokyo (Asia/Tokyo) is 10:45 PM (Tuesday). The UTC offset is +09:00. Daylight Saving Time is currently not active in this region.
```

**Prompt:** 
```
Show me the sunrise and sunset times for Lisbon today
```

**Response:** 
```
Retrieving astronomy data for Lisbon… Today, the sun rises at 7:12 AM and sets at 6:45 PM. The solar noon occurs at 12:58 PM, and the total day length will be 11 hours and 33 minutes.
```

## Capabilities

### Determine Physical Location
Resolve any IP address or coordinate set into detailed geographic data, including city, country, GPS coordinates, and local currency.

### Calculate Local Timezone Details
Get the exact local time, UTC offset, and daylight saving status for a given global location.

### Audit Network Infrastructure
Extract deep details about an IP address's network origin, including the ISP name and organization type.

### Track Celestial Events
Retrieve astronomical data like sunrise, sunset, and moon phases for specific dates and locations.

## Use Cases

### Troubleshooting a Global Bug
A developer notices an app bug only happens during certain hours. They ask their agent to use `get_timezone` on the user's IP range, confirming that the issue correlates exactly with Daylight Saving Time transitions in a specific region.

### Validating Server Traffic Origin
A security analyst receives an alert from a suspicious IP. They use this MCP to run `get_location` and immediately identify the country, GPS coordinates, and ISP name, narrowing down the investigation scope quickly.

### Displaying Local Event Times
An e-commerce site needs to show a flash sale time. The developer asks their agent to use `get_astronomy` combined with `get_timezone` to calculate the precise local start/end times for all users, ensuring accuracy everywhere.

### Localizing Pricing Audits
A data team is auditing pricing rules. They use this MCP's location features to check an IP address and pull not only the country but also the associated local currency symbol, ensuring localized pricing logic works.

## Benefits

- Pinpoint user location instantly. Use `get_location` to get GPS coordinates, city names, country codes, and even local currency symbols from an IP address—no extra lookups needed.
- Handle global scheduling correctly. With the `get_timezone` tool, you immediately know the precise local time, UTC offset, and whether Daylight Saving Time is active in a user's region.
- Improve data quality for logs. Data engineers can run network audits using this MCP to enrich server logs with accurate geolocation and ISP details, making analysis much smarter.
- Build context-aware features. Use `get_astronomy` when your application needs to know if it's daytime or night at a given location, powering things like localized event scheduling.
- Simplify complex logic. Instead of writing dozens of IF/THEN statements for time zones and countries, let your agent handle the complexity using structured data outputs.

## How It Works

The bottom line is you get deep, real-world global data—location, network status, and calendar metrics—all through your chat interface.

1. Subscribe to the MCP on Vinkius and enter your IPGeolocation API Key.
2. Invoke a tool in your agent using natural language prompts (e.g., 'What time is it in Tokyo?').
3. Your agent receives a structured data response containing geolocation, timezone, or astronomy details that you can use directly.

## Frequently Asked Questions

**How does IPGeolocation get accurate timezone data using the get_timezone tool?**
The `get_timezone` tool returns precise time and zone information, including knowing if Daylight Saving Time is currently active. This prevents errors that plague systems relying on simple UTC offsets.

**Can I use IPGeolocation to find the ISP details of an IP?**
Yes. The location intelligence features allow you to extract detailed ISP information and organization names associated with any given IP request, which is useful for security audits.

**Do I need a physical address to use get_astronomy?**
No. You can run `get_astronomy` using direct latitude and longitude coordinates when an IP address isn't available, giving you sunrise/sunset data for that exact spot.

**What kind of data does the get_location tool provide?**
The `get_location` tool returns comprehensive geographic details. Expect city names, country codes, GPS coordinates, and even the local currency symbol associated with the IP's jurisdiction.

**Is this MCP better than using a simple database lookup for time zones?**
Yes. This MCP uses live global data sources. It accounts for historical rules, political changes, and DST shifts that static databases often fail to track accurately.