IP2Location IP Geolocation MCP Server

Instructions

Implementation Reference

• src/server.py:32-74 (handler)

  The main handler function for the 'get_geolocation' tool. It constructs API parameters, fetches data from IP2Location.io using the helper function, and returns the result or an error message.
  async def get_geolocation(ip: str) -> Dict[str, Any] | str: """ Fetch geolocation for the given IP address. It helps users to retrieve detailed information such as country, region, city, latitude, longitude, ZIP code, time zone, ASN, and proxy information for any IPv4 or IPv6 address Args: ip: The IP address to analyze (IPv4 or IPv6). Returns: A JSON string result includes: Location & Geography: Country, region, district, city, ZIP code, latitude & longitude, time zone. Network & Connectivity ASN (Autonomous System Number), ISP (Internet Service Provider), domain, net speed, IDD code, area code, address type, usage type. Mobile Information MNC (Mobile Network Code), MCC (Mobile Country Code), Mobile Brand. Currency & Language currency code, currency name, currency symbol, language code, language name. Proxy & Security proxy type, last seen, threat level/type, proxy provider, fraud score. Others IAB category, weather, elevation, population and more. Note that some information may only available in paid plan. Learn more on this in https://www.ip2location.io/pricing. """ params = {"ip": ip} api_key = get_api_key() if api_key: params["key"] = api_key # IP2Location.io API key parameter geolocation_result = await make_request(IPLIO_API_BASE, params) if not geolocation_result: return f"Unable to fetch geolocation for IP {ip}." return geolocation_result
• src/server.py:33-63 (schema)

  Docstring defining the input schema (ip: str) and detailed output description for the tool.
  """ Fetch geolocation for the given IP address. It helps users to retrieve detailed information such as country, region, city, latitude, longitude, ZIP code, time zone, ASN, and proxy information for any IPv4 or IPv6 address Args: ip: The IP address to analyze (IPv4 or IPv6). Returns: A JSON string result includes: Location & Geography: Country, region, district, city, ZIP code, latitude & longitude, time zone. Network & Connectivity ASN (Autonomous System Number), ISP (Internet Service Provider), domain, net speed, IDD code, area code, address type, usage type. Mobile Information MNC (Mobile Network Code), MCC (Mobile Country Code), Mobile Brand. Currency & Language currency code, currency name, currency symbol, language code, language name. Proxy & Security proxy type, last seen, threat level/type, proxy provider, fraud score. Others IAB category, weather, elevation, population and more. Note that some information may only available in paid plan. Learn more on this in https://www.ip2location.io/pricing. """
• src/server.py:32-32 (registration)

  Registration of the 'get_geolocation' tool using the FastMCP @tool decorator.
  async def get_geolocation(ip: str) -> Dict[str, Any] | str:
• src/server.py:17-30 (helper)

  Helper function to make HTTP requests to the IP2Location.io API.
  async def make_request(url: str, params: dict[str, str]) -> dict[str, Any] | None: """Make a request to the IP2Location.io API with proper error handling.""" headers = { "User-Agent": USER_AGENT, "Accept": "application/json" } async with httpx.AsyncClient() as client: try: response = await client.get(url, headers=headers, params=params, timeout=30.0) response.raise_for_status() return response.json() except Exception: return None
• src/server.py:13-15 (helper)

  Helper function to retrieve the IP2Location.io API key from environment variable.
  def get_api_key() -> str | None: """Retrieve the API key from MCP server config.""" return os.getenv("IP2LOCATION_API_KEY")