IP2Location IP Geolocation MCP Server

Instructions

Implementation Reference

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

  The main execution logic for the get_geolocation tool: constructs API params with optional key, makes async request to IP2Location.io, returns parsed JSON or error string.
  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:17-30 (helper)

  Helper function that performs the async HTTP request to the IP2Location.io API endpoint with timeout, headers, and exception handling.
  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 the IP2LOCATION_API_KEY environment variable.
  def get_api_key() -> str | None: """Retrieve the API key from MCP server config.""" return os.getenv("IP2LOCATION_API_KEY")
• src/server.py:32-32 (registration)

  The @mcp.tool() decorator registers the get_geolocation function as an MCP tool.
  async def get_geolocation(ip: str) -> Dict[str, Any] | str: