Your Data · Attack Surface

`list_my_ip_addresses`

List IP addresses discovered across your assets, with geo/ASN/ISP enrichment. Costs 1 credit.

POST

tools/call

Cost: 1 credit per successful call · Scope: mcp:org · Response shape: jsonb

Returns data scoped to your own organisation only — the organisation is resolved from your API key and injected server-side, never read from the request.

Parameters

limitintegeroptionaldefault: 200

Maximum number of IP addresses to return. Accepted range: 1–1000.

Example invocation

Ask your agent: "List our exposed IP addresses and their hosting providers."

curl -s https://api.precursorintelligence.com/functions/v1/mcp \
  -H "Authorization: Bearer $PRECURSOR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_my_ip_addresses","arguments":{"limit":200}}}'

Response

result.content[0].text (parsed)

{
  "count": 2,
  "items": [
    {
      "ip": "40.99.153.136",
      "ip_version": 4,
      "scope": "external",
      "is_primary": true,
      "city": "Dublin",
      "country": "Ireland",
      "country_code": "IE",
      "asn": 8075,
      "isp": "Microsoft Corporation",
      "organization": "Microsoft Azure"
    },
    {
      "ip": "203.0.113.10",
      "ip_version": 4,
      "scope": "external",
      "is_primary": false,
      "city": "London",
      "country": "United Kingdom",
      "country_code": "GB",
      "asn": 16509,
      "isp": "Amazon.com, Inc.",
      "organization": "Amazon Data Services"
    }
  ],
  "generated_at": "2026-06-18T08:15:00.000Z"
}

The full MCP envelope, including _meta.precursor with request_id, credits, and response_truncated, is documented in Response Format.

Response fields

countintegeroptional

Number of IP addresses returned (equals items.length).

itemsarrayoptional

IP addresses discovered within your organisation. Each object contains the fields below.

items[].ipstringoptional

IP address, e.g. 40.99.153.136.

items[].ip_versionintegeroptional

IP version, 4 or 6.

items[].scopestringoptional

Address scope, e.g. external, internal.

items[].is_primarybooleanoptional

Whether this is the primary IP for its associated host.

items[].citystring | nulloptional

Geolocated city, when available.

items[].countrystring | nulloptional

Geolocated country name, when available.

items[].country_codestring | nulloptional

ISO 3166-1 alpha-2 country code, e.g. IE, GB.

items[].asninteger | nulloptional

Autonomous System Number for the address, when available.

items[].ispstring | nulloptional

Internet service provider, when available.

items[].organizationstring | nulloptional

Organisation associated with the address, when available.

generated_atstringoptional

ISO 8601 timestamp indicating when this response was generated.

Errors

Code	Message	When
`-32602`	`invalid_params: limit: min:1`	`limit` is less than 1
`-32602`	`invalid_params: limit: max:1000`	`limit` exceeds 1000
`-32001`	`unauthorized`	The API key is invalid/revoked, the IP is not allowed, or the key lacks the `mcp:org` scope.
`-32002`	`insufficient_credits`	Your credit balance is zero; top up from the dashboard
`-32603`	`internal`	Unexpected server error; the credit is automatically refunded