Your Data · Alerts

`get_my_alert_config`

Get your organisation's alert configuration: the watchlist entries (vendors/products/CVEs being monitored) and the notification recipient list. 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

This tool takes no parameters.

Example invocation

Ask your agent: "What are we watching for alerts and who gets notified?"

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":"get_my_alert_config","arguments":{}}}'

Response

result.content[0].text (parsed)

{
  "watch_entries": [
    {
      "list": "vendor",
      "cve_id": null,
      "vendor": "Fortinet",
      "product": null,
      "version": null,
      "created_at": "2026-02-11T10:00:00.000Z"
    },
    {
      "list": "product",
      "cve_id": null,
      "vendor": "Microsoft",
      "product": "Exchange Server",
      "version": "2019",
      "created_at": "2026-02-11T10:02:00.000Z"
    },
    {
      "list": "cve",
      "cve_id": "CVE-2024-3400",
      "vendor": "Palo Alto Networks",
      "product": "PAN-OS",
      "version": null,
      "created_at": "2026-04-12T09:30:00.000Z"
    }
  ],
  "recipients": ["secops@example.com", "ciso@example.com"],
  "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

watch_entriesarrayoptional

Watchlist entries your organisation is monitoring. Each object contains the fields below.

watch_entries[].liststringoptional

Which list the entry belongs to, e.g. vendor, product, or cve.

watch_entries[].cve_idstring | nulloptional

CVE identifier being watched, when the entry is a CVE.

watch_entries[].vendorstring | nulloptional

Vendor name being watched, where applicable.

watch_entries[].productstring | nulloptional

Product name being watched, where applicable.

watch_entries[].versionstring | nulloptional

Specific version being watched, where applicable.

watch_entries[].created_atstringoptional

ISO 8601 timestamp of when the watch entry was created (UTC).

recipientsarrayoptional

Email addresses that receive alert notifications for your organisation.

generated_atstringoptional

ISO 8601 timestamp indicating when this response was generated.

Errors

Code	Message	When
`-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