# IPGeolocation.io MCP

> IPGeolocation.io provides real-time intelligence for analyzing IP addresses, domains, and time zones directly through your AI client. Use this MCP to identify a location, check for VPN usage, determine network details (like ASN info), or calculate precise time zone shifts based on an IP address. It's essential for security analysis, localization logic, and data enrichment.

## Overview
- **Category:** security-compliance
- **Price:** Free
- **Tags:** ip-lookup, geolocation-api, threat-intelligence, timezone-api, cybersecurity

## Description

Look, sometimes you don't just need to know where an IP address is from; you need to know what it *means*. This MCP handles the full spectrum of network context. You can run checks on suspicious IPs to see if they are proxies or known threats, which saves time when vetting user submissions. It also gives you precise timezone data for any given location, so your application logic always calculates times correctly, regardless of where the user is. Plus, it breaks down complex browser strings into readable details. When you connect this via Vinkius, your AI client gets a full suite of tools to analyze network and geographical data without ever leaving the chat window. It’s basically having a whole security intelligence platform ready whenever you need it.

## Tools

### bulk_security
Checks multiple IP addresses at once to determine their security status or threat level.

### bulk_user_agent
Parses and categorizes a list of browser strings (User-Agents) into common device types and operating systems.

### convert_timezone
Calculates the exact time difference when moving a specific moment between two different time zones.

### get_abuse
Retrieves contact information for reporting abuse related to a given IP address block.

### get_asn
Provides technical details about the Autonomous System Number (ASN) associated with an IP range.

### get_astronomy
Retrieves astronomical data, like sunrise or sunset times, for a specified location.

### get_ip
Determines the public IP address that is currently making the request to your agent.

### get_ipgeo
Looks up geographical data, like city and country coordinates, from a single IP address.

### get_security
Checks the security status of one specific IP address to identify if it’s flagged as a threat or proxy.

### get_timezone
Determines the correct time zone identifier for any given location or IP address.

### get_user_agent
Analyzes a single browser string to extract details about the device and OS that generated it.

## Prompt Examples

**Prompt:** 
```
What is the geolocation of the IP 8.8.8.8?
```

**Response:** 
```
I've retrieved the data for 8.8.8.8. It is located in Mountain View, California, United States. The ISP is Google LLC. Would you like to see the full coordinate data?
```

**Prompt:** 
```
Check if the IP 185.245.87.12 is a VPN or a known threat.
```

**Response:** 
```
Analyzing security data... The IP 185.245.87.12 is identified as a VPN/Proxy with a threat score of 75. It is originating from a known data center. I recommend caution.
```

**Prompt:** 
```
Convert 10:00 AM from 'America/New_York' to 'Europe/London'.
```

**Response:** 
```
Using the timezone conversion tool... 10:00 AM in America/New_York corresponds to 3:00 PM in Europe/London on the same day.
```

## Capabilities

### Determine location details
Retrieve city, country, ISP, coordinates, and other geographical data for any IPv4 or IPv6 address.

### Assess network threat levels
Check if an IP is associated with a VPN, proxy, Tor node, or calculate its overall threat score.

### Manage time and date logic
Find the local time for any location or convert a specific time between two different time zones.

### Analyze network infrastructure data
Access details about an IP's Autonomous System Number (ASN) or find abuse contact information for reporting issues.

### Parse browser metadata
Break down a complex user-agent string into structured device and operating system information.

## Use Cases

### Vetting a user submission from an unknown IP
A security analyst receives an alert about an unusual login. Instead of manual lookups, the agent first runs `get_ipgeo` to determine the country and coordinates. Next, it uses `get_security` to check if the IP is flagged as a Tor node or proxy before alerting the team.

### Building an international scheduling tool
A developer needs to schedule a meeting that spans New York and Tokyo. The agent first uses `get_timezone` on both locations, then uses `convert_timezone` to calculate the precise overlap window, guaranteeing correct time display for all users.

### Auditing web form data
A data scientist is cleaning up user-submitted forms. They use `bulk_user_agent` on a batch of submissions and then run `get_ipgeo` to tag the dataset with precise location context, making analysis much richer.

### Debugging network logs
A DevOps engineer is troubleshooting a connection error. They use `get_asn` on the failed IP address to identify the owning network provider and then run `get_abuse` to find who they need to contact about the issue.

## Benefits

- Stop guessing about location. Use `get_ipgeo` to get immediate city, country, and coordinate data for any IPv4 or IPv6 address.
- Improve fraud detection. Run a quick check using `get_security` on suspicious IPs to see if they're known VPNs or proxies before processing the request.
- Fix scheduling bugs instantly. Never worry about time zones again; simply use `convert_timezone` to normalize times across global users.
- Enrich your data pipelines. When you need context, run `get_asn` to understand which network infrastructure owns an IP range, adding critical detail to your reports.
- Handle client variation easily. Instead of writing complex regex for browser types, let the agent use `get_user_agent` to parse device metadata automatically.

## How It Works

The bottom line is you get reliable, real-time access to deep network intelligence without writing a single API call yourself.

1. Subscribe to this MCP and paste your API key.
2. Your AI client uses natural language prompts to call the available tools, passing in necessary parameters like IP addresses or timezones.
3. The MCP processes the query against its network databases and returns structured data (e.g., JSON) that your agent can use for further analysis.

## Frequently Asked Questions

**How do I use get_ipgeo with an IP address?**
You simply tell your agent to 'get the location for 8.8.8.8.' The tool handles the lookup, returning precise city, country, and coordinate data.

**Can I check multiple IPs at once using bulk_security?**
Yep. Use `bulk_security` when you have a list of IPs (like from a CSV file). It runs the threat check on every IP in the batch and returns a summary for all of them.

**What is the difference between get_ipgeo and get_timezone?**
Geo provides *where* an IP is (country, city), while `get_timezone` tells you the correct time zone identifier (like 'America/Los_Angeles') for that location.

**When should I use convert_timezone?**
Use it whenever a conversation or data point involves two different locations. It calculates the exact corresponding time, preventing scheduling errors.

**How does get_user_agent help with client identification?**
`get_user_agent` takes a browser string and breaks it into structured parts, telling you the device type (e.g., mobile) and the operating system that generated it.

**What happens if I make too many calls using `get_ipgeo`?**
You will encounter a rate limit error. The API response includes an HTTP status code and often specifies when you can retry the request. Always manage your calling volume to avoid service interruptions.

**When should I use `get_asn` instead of general IP location data?**
Use it when network ownership matters more than geography. While basic lookups give you a city, running `get_asn` gives you the Autonomous System Number, which identifies the specific organization that owns the entire block of IP addresses.

**How do I find out who to contact if an IP address is causing problems?**
Use the `get_abuse` tool. This retrieves the designated abuse contact information for a given IP range or block. It lets you report network issues directly to the right party, bypassing general support channels.

**Can I detect if an IP address is a VPN or a security risk?**
Yes. Use the `get_security` tool to retrieve a threat score and detect if the IP belongs to a VPN, Proxy, or Tor network. You can also use `bulk_security` for multiple IPs.

**How do I find the local time for a specific IP address?**
Simply use the `get_timezone` tool with the target IP. It will return the current time, date, and full timezone details for that specific geographical location.

**Can I look up ASN information for a network?**
Yes, the `get_asn` tool provides detailed information about Autonomous System Numbers, including routes and WHOIS responses for a specific ASN or IP.