Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Schema
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_ip_details | 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:
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. |
| get_ipinfo_api_token | Check if the IPINFO_API_TOKEN environment variable is configured for enhanced IP lookups. This tool verifies whether the IPInfo API token is properly configured in the environment. The token enables access to premium features like ASN information, privacy detection, carrier details, and enhanced accuracy for IP geolocation analysis. Common use cases:
Args: ctx: The MCP request context. Returns: bool: True if IPINFO_API_TOKEN environment variable is set and configured, False if the token is missing or not configured. Examples: # Check if premium features are available has_token = get_ipinfo_api_token() if has_token: # Safe to use advanced IP analysis features details = get_ip_details("8.8.8.8") # Will include ASN, privacy data else: # Limited to basic IP information only details = get_ip_details("8.8.8.8") # Basic location/ISP only # Use in conditional workflows
if get_ipinfo_api_token():
# Perform advanced IP geolocation analysis
pass
else:
# Fall back to basic analysis or prompt for token configuration
pass Note: The IPInfo API provides basic location and ISP information without authentication, but premium features (ASN details, VPN/proxy detection, carrier information, enhanced accuracy) require a valid API token from https://ipinfo.io/. |