Bulk IP Geolocation
bulk_lookup_ipLook up geolocation, ASN, security, and abuse data for up to 250 IPs or domains in one batch request; retrieve oversized results through cached pages.
Instructions
Read-only bulk IP lookup via POST /v3/ipgeo-bulk. Documented as paid-only; the upstream API determines plan access. Base IP data costs 1 credit per valid IP; security adds 2 and abuse adds 1. Selecting only security costs 2, only abuse costs 1, and security plus abuse without base data costs 3 per valid IP. This MCP server accepts up to 250 IPs per request. Larger batches are rejected before any API call. Complete results within upstream and cache byte limits are returned directly or as cached pages. Cached pages use get_cached_result without another API call or additional credits. An upstream body above its byte limit, or a required pagination snapshot too large to retain, returns a non-retryable resource_limit error with no cursor; the API may already have used credits.
The response covers location data or mixed IP data domains for multiple IPs or domains. Private, bogon, and malformed IPs are not billed. fields, excludes, lang, and include behave like lookup_ip for each item; this server also infers include modules from fields. bulk_security_check provides dedicated security-only batch responses.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"ips": "<ips>"
},
"name": "bulk_lookup_ip"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ips | Yes | Array of IPv4 and/or IPv6 addresses to look up. Minimum 1, maximum 250 in this MCP server. Domain names are also accepted. | |
| lang | No | Response language code (en, de, ru, ja, fr, cn, es, cs, it, ko, fa, pt, ar). Defaults to en. | |
| fields | No | Comma-separated dot-path fields to return per IP (e.g. location.city,asn.organization). Reduces response size and can reduce credit cost when combined with include. Fields under security or abuse auto-add that module. location.accuracy_radius/confidence/locality auto-add geo_accuracy; location.dma_code auto-adds dma_code. Optional modules require a paid plan. | |
| include | No | Comma-separated extra modules to include per IP. Options: security (+2 credits/IP), abuse (+1 credit/IP), hostname, liveHostname, hostnameFallbackLive, user_agent, geo_accuracy, dma_code, or *. An unfiltered paid * response costs 4 credits/IP; fields/excludes can reduce returned modules and cost. | |
| excludes | No | Comma-separated dot-path fields to exclude per IP (e.g. currency,time_zone). | |
| force_refresh | No | Default false. When true, bypasses cached bulk geolocation data; a successful refresh makes a new upstream request and can consume credits. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | ||
| error | No | Present when the whole tool call fails, with isError: true. | |
| items | No | Present on success: complete API results in input order, including any per-item error messages. | |
| errors | No |