IPLocate

Retrieves geographic location data for a given IP address by calling the IPLocate.io API through the lookup_ip_address_location tool, returning structured fields including country, city, coordinates, timezone, and postal code. The MCP server translates client requests into authenticated HTTP calls to IPLocate.io's geolocation endpoint, parsing and returning JSON-structured responses that include latitude/longitude precision and timezone identifiers for location-aware applications.

Detects privacy-masking technologies by calling the lookup_ip_address_privacy tool, which queries IPLocate.io's security flags to identify whether an IP is associated with a VPN provider, proxy service, Tor exit node, or hosting provider. The server returns boolean flags and provider classifications that enable security systems to identify obfuscated traffic and enforce access policies based on connection type.

Retrieves network infrastructure details by calling the lookup_ip_address_network tool, which returns ASN name, ASN number, network type, network range (CIDR), and ISP details from IPLocate.io. The server translates IP addresses into structured network metadata that identifies the autonomous system and network operator, enabling network analysis, peering investigations, and infrastructure-level security decisions.

Extracts business and organizational information by calling the lookup_ip_address_company tool, which returns organization name, domain, and business classification for a given IP address. The server queries IPLocate.io's company database to identify which organization operates or is associated with an IP, enabling business intelligence and account-based security workflows.

Retrieves abuse reporting contacts by calling the lookup_ip_address_abuse_contacts tool, which returns email addresses and contact information for reporting security incidents, spam, or abuse associated with an IP address. The server queries IPLocate.io's abuse contact database to identify the appropriate network operator or ISP contact for incident response, enabling automated abuse reporting workflows.

Provides complete IP address intelligence by calling the lookup_ip_address_details tool, which aggregates all available data categories (geolocation, network, privacy, company, abuse contacts) into a single comprehensive response. The server returns a unified JSON object containing all IP metadata from IPLocate.io, enabling single-call analysis for applications requiring multi-dimensional IP intelligence without sequential tool invocations.

Implements the Model Context Protocol (MCP) server using @modelcontextprotocol/sdk, registering six specialized IP lookup tools and four prompt templates with the McpServer instance. The server communicates with MCP clients (Claude Desktop, Cursor, VS Code) via stdio transport, translating client requests into tool invocations and returning structured responses through the MCP protocol, enabling seamless integration with AI development tools.

Provides four pre-configured prompt templates that combine multiple IP lookup tools into higher-level analysis workflows, enabling AI agents to perform complex IP intelligence tasks without manual tool orchestration. The templates guide AI reasoning through structured prompts that invoke multiple tools in sequence, aggregate results, and produce actionable insights for specific use cases (e.g., security investigation, business intelligence).

Validates and normalizes IPv4 and IPv6 addresses before API calls through input validation logic in the MCP server, ensuring only well-formed IP addresses are sent to IPLocate.io. The server checks address format compliance (e.g., valid octets for IPv4, valid hex groups for IPv6) and returns structured error responses for invalid inputs, preventing malformed requests and API errors.

Manages authenticated HTTP communication with IPLocate.io's API through a fetchIPData() function that handles API key authentication, request construction, and response parsing. The server reads the IPLocate.io API key from the IPLOCATE_API_KEY environment variable, constructs authenticated requests with appropriate headers, and translates API responses into MCP-compatible JSON structures for client consumption.