Company/Organization Lookup
lookup_companyRead-only ownership lookup via GET /v3/ipgeo. Company details require a paid plan; free plans return basic ASN ownership only. Cost: 1 credit.
Instructions
Read-only ownership lookup via GET /v3/ipgeo. Company details require a paid plan; free plans return basic ASN ownership only. Cost: 1 credit. This response is limited to company and ASN ownership; lookup_ip can return ownership together with location, security, abuse, network, timezone, or currency.
Returns { company, asn }: company name/type/domain plus ASN allocation fields when available. ip omitted means the server's public egress IP. 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": "lookup_company"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ip | No | IPv4 or IPv6 address to look up. Omit to check the server's public egress IP. | |
| force_refresh | No | Default false. When true, bypasses cached ownership 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. |