Your Data · Attack Surface

`list_my_network_ranges`

List the network CIDR ranges attributed to your organisation. 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 ranges to return. Accepted range: 1–1000.

Example invocation

Ask your agent: "What network ranges do we own?"

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_network_ranges","arguments":{"limit":200}}}'

Response

result.content[0].text (parsed)

{
  "count": 2,
  "items": [
    {
      "cidr": "203.0.113.0/24",
      "netname": "PRECURSOR-EDGE",
      "description": "Precursor Security external edge range",
      "organization": "Precursor Security Ltd",
      "country_code": "GB",
      "asn": 64500
    },
    {
      "cidr": "198.51.100.0/24",
      "netname": "PRECURSOR-CORP",
      "description": "Corporate office range",
      "organization": "Precursor Security Ltd",
      "country_code": "GB",
      "asn": 64500
    }
  ],
  "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 ranges returned (equals items.length).

itemsarrayoptional

Network ranges attributed to your organisation. Each object contains the fields below.

items[].cidrstringoptional

The network range in CIDR notation, e.g. 203.0.113.0/24.

items[].netnamestringoptional

The registered network name from the regional internet registry.

items[].descriptionstringoptional

Human-readable description of the range.

items[].organizationstringoptional

The organisation the range is registered to.

items[].country_codestringoptional

ISO 3166-1 alpha-2 country code for the registration.

items[].asnintegeroptional

The autonomous system number associated with the range.

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