Look Up IPs
ipinfo_lookup_ipsLook up geolocation, ISP, and ASN details for one or more IP addresses. Results returned in input order with optional full or summary detail.
Instructions
Geolocate one or more IPs and return ISP/ASN details.
Returns a list in input order (after dedup and invalid-IP filtering); match
results back to your input via the ip field. IPs that fail upstream are
omitted and logged; if the batch resolves no IPs at all the failure is
raised rather than masked — auth_insufficient_scope when the upstream
returned nothing (token tier likely lacks /batch access; look IPs up one
at a time or upgrade to Core+), otherwise a retryable api_error. Defaults
to detail="summary" (heavy nested blocks
omitted); pass detail="full" for every field. Capped at 1,000 IPs per
call (too_many_ips above that): this tool returns one record per IP, so
for larger batches use ipinfo_summarize_ips (fixed-size aggregates) or
ipinfo_generate_map_url. Higher plan tiers populate more fields; see the
server instructions for the Lite/Core/Plus/Enterprise tier mapping. For
VPN/Tor/open-proxy/hosting detection read the privacy flags on each
record; for residential-proxy exit-node classification use the separate
ipinfo_check_residential_proxy tool. Typically completes in seconds;
bounded by a 120s tool timeout that surfaces as a timeout envelope.
Errors raise ToolError with a JSON-encoded envelope.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ips | Yes | IPv4/IPv6 addresses to look up. Invalid or special-use IPs are filtered. | |
| detail | No | 'summary' (default) OMITS heavy nested blocks (continent, country_flag*, country_currency, abuse, domains) for batch token savings; 'full' returns every IPDetails field. | summary |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |