Geolocate the calling client's own IP. No arguments.

On stdio transports the result is this server's outbound IP, not the end user's. Use ipinfo_lookup_ips when the caller already has a specific IP. Errors raise ToolError with a JSON-encoded envelope.

Geolocate one or more IPs and return ISP/ASN details.

Returns a list of IPDetails in input order (after dedup and invalid-IP filtering). Match results back to your input via the ip field. Capped at 500,000 IPs per call (too_many_ips if exceeded). Higher plan tiers populate more fields; see the server instructions for the Lite/Core/Plus/Enterprise tier mapping. Errors raise ToolError with a JSON-encoded envelope.

Classify whether an IP is a known residential-proxy exit node.

Returns ResidentialProxyDetails with is_residential_proxy (the canonical yes/no), and — when true — service, last_seen (YYYY-MM-DD), and percent_days_seen over a 7-day window. Useful for fraud, bot, and ad-fraud detection. Requires IPINFO_API_TOKEN with the Enterprise residential-proxy add-on; absence surfaces as auth_insufficient_scope (distinct from auth_invalid for a missing/wrong token).

Build an interactive ipinfo.io map for a set of IPs.

Returns MapResult{url, mapped_ip_count, skipped_ips, skipped_count, truncated}. skipped_ips is a list of {ip, reason} entries for filtered inputs, capped at 100; truncated flags overflow. skipped_count is the true total even when the list is capped, so mapped_ip_count + skipped_count equals the input length. Errors raise ToolError with a JSON-encoded envelope.

[DEPRECATED in 0.5.0 — use ipinfo_lookup_my_ip / ipinfo_lookup_ips. Removed in 0.6.0.]

Forwards to ipinfo_lookup_my_ip when called with no ips (or ips=None), and to ipinfo_lookup_ips otherwise. Behavior is otherwise unchanged.

[DEPRECATED in 0.5.0 — use ipinfo_check_residential_proxy. Removed in 0.6.0.]

[DEPRECATED in 0.5.0 — use ipinfo_generate_map_url. Removed in 0.6.0.]

Returns just the bare map URL string for 0.4.x cached-client parity. Callers wanting structured skip/truncation metadata should call ipinfo_generate_map_url directly.