VPN/Proxy/Threat Detection
check_securityCheck an IP address for VPN, proxy, Tor, bot, spam, and known-attacker signals with a read-only threat-score lookup.
Instructions
Read-only security lookup via GET /v3/security. Paid only. Cost: 2 credits. This endpoint is dedicated to security and threat data; lookup_ip with include=security provides security data together with location, company, ASN, network, timezone, currency, or abuse.
Returns { ip, security } with threat_score, VPN, proxy, residential proxy, Tor, relay, anonymity, bot, spam, known attacker, and cloud-provider fields; provider names, confidence scores, and last_seen dates appear when available.
fields/excludes accept comma-separated security.* dot paths; ip is always returned. Threat scores and flags are indicators, not a safety guarantee; missing or unknown data is inconclusive. This queries IP intelligence, not the separate live browser detection API. force_refresh bypasses cached data, makes a new upstream request, and can consume credits.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "check_security"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ip | No | IPv4 or IPv6 address to check. Omit to check the server's public egress IP. | |
| fields | No | Comma-separated dot-path fields to return (e.g. security.threat_score,security.is_vpn). Reduces response size. | |
| excludes | No | Comma-separated dot-path fields to exclude (e.g. security.is_tor,security.is_cloud_provider). | |
| force_refresh | No | Default false. When true, bypasses cached security data; a successful refresh makes a new upstream request and can consume credits. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | Present on success: API result after field selection, redaction, and transport limits. | |
| page | No | ||
| error | No | Present on failure, with isError: true. |