Bulk Security Check
bulk_security_checkCheck security details for up to 250 IPv4 or IPv6 addresses in one request, returning per-IP threat, VPN, proxy, Tor, bot, hosting, and spam data for batch risk review.
Instructions
Read-only bulk security lookup via POST /v3/security-bulk. Paid only. Cost: 2 credits per valid IP. This MCP server accepts up to 250 IPs; private, bogon, and malformed IPs are not billed. 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.
This endpoint is dedicated to security-only batches; bulk_lookup_ip with include=security provides security data together with geolocation or other IP domains. Returns one { ip, security } result per valid IP. fields/excludes accept security.* dot paths per item. force_refresh bypasses cached data, makes a new upstream request, and can consume credits.
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_security_check"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ips | Yes | Array of IPv4 and/or IPv6 addresses to check. Minimum 1, maximum 250 in this MCP server. | |
| fields | No | Comma-separated dot-path fields to return per IP (e.g. security.threat_score,security.is_vpn). Reduces response size. | |
| excludes | No | Comma-separated dot-path fields to exclude per IP (e.g. security.is_tor,security.is_cloud_provider). | |
| force_refresh | No | Default false. When true, bypasses cached bulk security 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 |