# IPinfo MCP

> IPinfo lets you conduct deep network audits instantly. Your agent can geolocate IPs, check Autonomous System Numbers (ASN) for ownership details, and determine if an IP is a proxy or VPN exit node—all without needing to touch a terminal or read documentation. Use this MCP to analyze vast amounts of IP data for security research, infrastructure planning, and risk management.

## Overview
- **Category:** cloud-infrastructure
- **Price:** Free
- **Tags:** ip-geolocation, asn-lookup, network-intelligence, privacy-metadata, cybersecurity, data-enrichment

## Description

Need to understand where an IP address really comes from? This MCP connects your AI agent to industry-leading network intelligence, letting you query complex geographical and ownership data conversationally. Instead of jumping between spreadsheets and specialized lookup tools, you ask your agent a question—'Is this range associated with known proxy networks?'—and it handles the whole audit process. You get instant answers on city location, ISP details, or if the IP is flagged as private or VPN-related.

When you connect this MCP via Vinkius, your AI client acts like a full-time network analyst for you. You can analyze an entire CIDR block to see where all its IPs land geographically, or check the historical data on a single address. The result is immediate, high-fidelity intelligence that helps ground your work in verifiable facts, whether you're monitoring user traffic or building secure infrastructure.

## Tools

### get_asn_details
Retrieves specific ownership and details for any given Autonomous System Number (ASN).

### get_ip_details
Gets the full geographic, network, and ISP information for a single IP address.

### get_ip_historical
Retrieves past data points or changes associated with an IP address (requires proper plan).

### get_ip_range
Gathers metadata and details for a defined range of IPs or CIDR block.

### get_own_ip_details
Fetches the specific network and location data for the machine running your agent right now.

### get_privacy_details
Checks if a given IP address is known to belong to a VPN, proxy, or Tor service.

## Prompt Examples

**Prompt:** 
```
Geolocate the IP address 1.1.1.1 using IPinfo.
```

**Response:** 
```
I've geolocated the IP! It is located in Research, Victoria, Australia. The provider is identified as Cloudflare. Would you like the full network and ASN details?
```

**Prompt:** 
```
Check if IP 8.8.8.8 is using a VPN.
```

**Response:** 
```
I've checked the privacy settings for 8.8.8.8. It is not identified as a VPN, proxy, or Tor exit node. It is a public DNS IP provided by Google. Would you like to see the ASN info?
```

**Prompt:** 
```
Show ASN details for AS15169.
```

**Response:** 
```
I've retrieved the details for AS15169. It belongs to Google LLC and has over 15 million IPs allocated. Would you like to see the domains associated with this ASN?
```

## Capabilities

### Audit IP location and network details
Retrieves full geographic data for a specific IP address, including city, region, and ISP.

### Identify ownership via ASNs
Looks up Autonomous System Numbers (ASN) to determine the corporate or network entity that owns the IP range.

### Check for privacy masking
Determines if an IP address is linked to VPN, proxy, or Tor exit nodes.

### Analyze entire IP ranges
Gathers metadata across a CIDR block or specified range of IP addresses.

### Audit current system connection
Pulls specific network details about the IP address currently running your agent.

## Use Cases

### Investigating Suspicious User Traffic
A security analyst notices a spike in traffic from an unknown source. The agent uses get_ip_details and get_privacy_details to confirm the IP isn't using common VPN exit nodes, narrowing the investigation scope immediately.

### Verifying New Infrastructure Deployments
A data engineer needs to ensure a new regional deployment uses IPs from an approved block. They run get_ip_range on the CIDR and use get_asn_details to confirm the ownership aligns with corporate records.

### Auditing Compliance for Third Parties
A risk manager needs proof that a vendor's connection IPs are not masked. The agent executes multiple checks using get_privacy_details across various IP ranges to generate an audit trail.

### Troubleshooting Connection Failures
An ops lead suspects connectivity issues. Instead of manual diagnostics, they run get_own_ip_details to confirm the current server connection is operating from the expected physical location and ISP.

## Benefits

- Stop guessing about data source location. Use get_ip_details to pinpoint the exact city, region, or ISP for any IP address in seconds.
- Automate ownership checks with get_asn_details. You can immediately verify which large organization owns a network block without leaving your workflow.
- Audit user traffic integrity using get_privacy_details. Quickly spot if an IP is masked by a proxy or VPN, improving threat detection.
- Manage infrastructure risk by running get_ip_range. Check entire CIDR blocks at once to understand regional allocations and compliance boundaries.
- Maintain full control over your setup. Use get_own_ip_details whenever you need absolute certainty about the connection environment your agent is operating from.

## How It Works

The bottom line is that you tell your AI client what network information you need, and it handles all the complex data lookups using this MCP.

1. Subscribe to this MCP and provide your IPinfo Access Token.
2. Connect the MCP to your preferred AI client (Claude, Cursor, etc.) via Vinkius.
3. Ask your agent a question like, 'Check the location and ASN details for 10.0.0.1' to execute the network audit.

## Frequently Asked Questions

**How does IPinfo MCP help with geolocation?**
The get_ip_details tool retrieves the full geographic information for any IP address, providing city, region, and ISP data points right away.

**Can I check if an entire range of IPs is private or masked using IPinfo MCP?**
Yes. You can use get_ip_range to analyze a CIDR block, and then leverage the privacy checking capabilities to audit the whole spectrum for VPNs or proxies.

**What is the difference between get_ip_details and getting my own IP?**
get_ip_details works on any arbitrary IP you provide. If you want to know details about the machine running your agent, use get_own_ip_details.

**Is this MCP useful for checking network ownership?**
Absolutely. Use the get_asn_details tool whenever you need to confirm which corporation or entity owns a specific Autonomous System Number (ASN).