IPInfo MCP Server

Instructions

Implementation Reference

• src/mcp_ipinfo/server.py:498-517 (handler)

  The handler function for the 'get_ip_hostname' tool, decorated with @mcp.tool() for registration. It fetches the hostname for a given IP address (or current IP if none provided) using the IPInfoClient, handling API errors appropriately.
  @mcp.tool() async def get_ip_hostname(ctx: Context[Any, Any, Any], ip: str | None = None) -> str: """Get just the hostname for an IP address. Args: ip: IP address to lookup. If None, returns current hostname. Returns: Hostname. """ client = get_client(ctx) try: if ip: return await client.get_hostname_by_ip(ip) else: return await client.get_current_hostname() except IPInfoAPIError as e: ctx.error(f"API error: {e.message}") raise
• src/mcp_ipinfo/server.py:498-498 (registration)

  The @mcp.tool() decorator registers the get_ip_hostname function as an MCP tool.
  @mcp.tool()
• src/mcp_ipinfo/server.py:29-38 (helper)

  Helper function to get or initialize the shared IPInfoClient instance, used by get_ip_hostname and other tools.
  def get_client(ctx: Context[Any, Any, Any]) -> IPInfoClient: """Get or create the API client instance.""" global _client if _client is None: api_token = os.environ.get("IPINFO_API_TOKEN") if not api_token: ctx.warning("IPINFO_API_TOKEN is not set - some features may be limited") _client = IPInfoClient(api_token=api_token) return _client