# IPGeolocation MCP for AI Agents AI Agent Connect

> IPGeolocation MCP lets you turn IP addresses into rich geographic and temporal data. Use it to find precise locations, local timezones, ISP details, and even sunrise/sunset times for any point on Earth. It's for anyone who needs to know where a user is actually coming from or what the local context is right now.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_zgOsd32pBj8x0EIu4pzi9sVtlFMzJhp4Hbpkeoak/ai-agent-connect
- **Tags:** geolocation, ip-intelligence, timezone-data, astronomy-data, network-audit, localization

## Description

Imagine you're building a global app and need to show the right currency or local time based on where a user is sitting. Usually, that means jumping between different APIs, handling weird timezone offsets, and trying to guess which country a specific IP belongs to. This Connector handles that heavy lifting for you. You can just ask your agent to tell you the local time in a specific city or find out which ISP a suspicious IP address is coming from. It pulls in everything from GPS coordinates to moon phases for specific Earth locations.

If you're looking for a way to manage multiple tools in one place, the Vinkius catalog makes it easy to plug this in alongside your other integrations. Instead of manual lookups, your agent becomes a research assistant that knows exactly what's happening on the ground anywhere in the world. You don't have to worry about the technical details of how the data is fetched or how to format the results. It's about getting the right context without the extra tabs. Whether you're trying to verify a user's location for security reasons or you're just trying to make sure your pricing looks correct in a different country, this tool gives you the data you need in plain English. You get a consistent way to handle global data without the usual friction of manual research.

## Tools

### get_astronomy
Fetch sunrise, sunset, and moon phase data. Use this for apps that need location-aware environmental data.

### get_timezone
Get the local time and timezone info for a specific location. It's great for handling DST automatically.

### get_location
Resolve an IP address into detailed geographic data. This gives you city, country, and GPS coordinates in one go.

## Prompt Examples

**Prompt:** 
```
Where is IP 1.1.1.1 coming from and what's the local time?
```

**Response:** 
```
### IP Intelligence Results

*   **Location:** Mountain View, California, United States
*   **ISP:** Google LLC
*   **Coordinates:** 37.4223, -122.0841
*   **Local Time:** 10:45 AM (Tuesday)
*   **Currency:** USD ($)

This address is currently identified as a residential/corporate connection in the US.
```

**Prompt:** 
```
What's the sunrise time in Paris today?
```

**Response:** 
```
### Astronomy Data: Paris

*   **Sunrise:** 7:12 AM
*   **Sunset:** 6:45 PM
*   **Solar Noon:** 12:58 PM
*   **Day Length:** 11 hours and 33 minutes

Note: These times are based on current seasonal metrics for the region.
```

**Prompt:** 
```
Give me the currency and timezone for a user in Brazil.
```

**Response:** 
```
### Regional Context: Brazil

*   **Local Time:** 10:45 PM (Tuesday)
*   **UTC Offset:** -03:00
*   **Daylight Saving:** Not active
*   **Currency:** Brazilian Real (R$)

This information is ready for your localized pricing and display logic.
```

## Capabilities

### Map IP addresses to city and country names
Get precise geographic data for any IPv4 or IPv6 address.

### Identify the ISP and organization
Extract network details to see who owns the IP address.

### Fetch local time and UTC offsets
Retrieve current time and timezone status for any location.

### Get sunrise, sunset, and moon phase data
Access astronomy metrics for specific Earth coordinates.

### Lookup local currency symbols
Find the currency names and symbols for specific jurisdictions.

### Query geographic data using coordinates
Perform location lookups using raw latitude and longitude.

## Use Cases

### Security Incident Response
An analyst asks the agent to use get_location to check if an IP belongs to a residential ISP or a cloud provider during a breach.

### E-commerce Localization
A developer wants to know the local currency for a specific country to show correct pricing using the geo data.

### Logistics and Astronomy
A user asks for the moon phase and sunset time for a specific shipping route using get_astronomy.

### Data Enrichment
A data engineer needs to group server logs by country and city automatically using get_location.

## Benefits

- Stop guessing timezones by using get_timezone to handle UTC offsets and DST data automatically.
- Identify the infrastructure behind a request using get_location to see ISP and organization names.
- Power location-aware features with get_astronomy to show sunrise and sunset times for your users.
- Localize pricing instantly by pulling currency symbols and names from specific jurisdictions.
- Reduce manual research by having your agent resolve coordinates for any point on Earth.

## How It Works

The bottom line is you get instant, accurate geographic and temporal context for any point on the globe.

1. Subscribe to the Connector in the Vinkius catalog.
2. Provide your IPGeolocation API key in the configuration.
3. Ask your agent to resolve an IP or coordinate for any of the data points.

## Frequently Asked Questions

**Can the IPGeolocation MCP find the city of a visitor?**
Yes, it resolves an IP address to a specific city, country, and GPS coordinates. This helps you understand exactly where your users are coming from.

**Does the IPGeolocation MCP handle Daylight Saving Time?**
Yes, it provides the current UTC offset and DST status for any location. This ensures your app always shows the correct local time.

**Can I use the IPGeolocation MCP for astronomy data?**
You can get sunrise, sunset, and moon phase metrics for any set of coordinates. This is perfect for location-aware environmental features.

**Does the IPGeolocation MCP show ISP information?**
It identifies the organization and connection type for a given IP address. This is a key tool for identifying the infrastructure behind a request.

**Can the IPGeolocation MCP help with local currency?**
It retrieves the local currency name and symbol for specific jurisdictions. You can use this to automate localized pricing across different regions.

**How do I get location data without an IP?**
You can provide latitude and longitude coordinates to get the same geographic details. This lets you perform lookups even when an IP isn't available.

**Can I resolve a location using GPS coordinates instead of an IP address?**
Yes. Tools like `get_timezone` and `get_astronomy` accept optional latitude and longitude parameters. This allows your agent to retrieve environmental and temporal data for any point on Earth, even if you don't have a target IP.

**How do I check if a specific location is currently observed in Daylight Saving Time (DST)?**
Use the `get_timezone` tool by providing a timezone name (e.g. 'America/New_York'). Your agent will return the full timezone payload, including the `is_dst` boolean and current UTC offset.

**Can my agent find out the sunrise and sunset times for a given IP?**
Absolutely. Use the `get_astronomy` tool and provide the target IP. Your agent will calculate the precise location and return astronomical data including sunrise, sunset, solar noon, and day length.