get_ip_details

Instructions

Get detailed information about an IP address including location, ISP, and network details.

This tool provides comprehensive IP address analysis including geographic location, internet service provider information, network details, and security context. Use when you need to understand the user's location, ISP, and network details or those of a given IP address.

Common use cases:

Analyze user's current location and connection details (leave ip parameter blank)
Investigate suspicious IP addresses for security analysis
Determine geographic distribution of website visitors or API users
Look up ISP and hosting provider information for network troubleshooting
Get timezone information for scheduling or time-sensitive operations
Verify if an IP belongs to a VPN, proxy, or hosting provider
Check country-specific compliance requirements (EU, etc.)

Args: ip: The IP address to analyze (IPv4 or IPv6). If None or not provided, analyzes the requesting client's IP address. ctx: The MCP request context.

Returns: IPDetails: Comprehensive IP information including:

Basic Info:
- ip: The IP address that was analyzed
- hostname: Associated hostname/domain name
- org: Organization/ISP name (e.g., "Google LLC", "Comcast Cable")
- ts_retrieved: The timestamp when the IP address was looked up (UTC)

Geographic Location:
- city: City name
- region: State/province/region name
- country: Two-letter ISO country code (e.g., "US", "GB")
- country_name: Full country name
- postal: ZIP/postal code
- loc: Coordinates as "latitude,longitude" string
- latitude/longitude: Separate coordinate values
- timezone: IANA timezone identifier (e.g., "America/New_York")

Regional Info:
- continent: Continent information dictionary
- country_flag: Country flag image data
- country_flag_url: URL to country flag image
- country_currency: Currency information for the country
- isEU: True if country is in European Union

Network/Security Info (some features require paid API plan):
- asn: Autonomous System Number details
- privacy: VPN/proxy/hosting detection data
- carrier: Mobile network operator info (for cellular IPs)
- company: Company/organization details
- domains: Associated domain names
- abuse: Abuse contact information
- bogon: True if IP is in bogon/reserved range
- anycast: True if IP uses anycast routing

Examples: # Get your own IP details my_info = get_ip_details()

# Analyze a specific IP
server_info = get_ip_details("8.8.8.8")

# Check if IP is from EU for GDPR compliance
details = get_ip_details("192.168.1.1")
is_eu_user = details.isEU

Note: Some advanced features (ASN, privacy detection, carrier info) require an IPINFO_API_TOKEN environment variable with a paid API plan. Basic location and ISP info works without authentication.

Input Schema

Name	Required	Description	Default
`ip`	No	The IP address to analyze (IPv4 or IPv6). If None or not provided, analyzes the requesting client's IP address.

Input Schema (JSON Schema)

{
  "properties": {
    "ip": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "The IP address to analyze (IPv4 or IPv6). If None or not provided, analyzes the requesting client's IP address.",
      "examples": [
        "8.8.8.8",
        "2001:4860:4860::8888",
        null
      ],
      "title": "Ip"
    }
  },
  "type": "object"
}

IP Geolocation MCP Server

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from IP Geolocation MCP Server

Related Tools

MCP directory API