CVE & EPSS

`list_recent_notable_events`

Returns CVE notable events recorded within a rolling time window: new NVD entries, high EPSS score jumps, CISA KEV additions, and similar signals. Costs 1 credit.

POST

tools/call

Cost: 1 credit per successful call · Response shape: jsonb

Parameters

event_typestringoptional

Filter results to a single event type. Maximum 40 characters, pattern ^[A-Za-z0-9_]+$. Known values: NEW_NVD, HIGH_EPSS_DELTA, LOW_EPSS_DELTA, NEW_CISA. Omit to return all event types.

daysintegeroptionaldefault: 7

Look-back window in days. Accepted range: 1–30.

limitintegeroptionaldefault: 100

Maximum number of events to return. Accepted range: 1–500.

Example invocation

Ask your agent: "Show me any CISA KEV additions from the last 3 days."

curl -s https://mcp.precursorintelligence.com \
  -H "Authorization: Bearer $PRECURSOR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_recent_notable_events","arguments":{"event_type":"NEW_CISA","days":3,"limit":50}}}'

Response

result.content[0].text (parsed)

{
  "count": 2,
  "event_type": "NEW_CISA",
  "days": 3,
  "limit": 50,
  "items": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "cve": "CVE-2024-3094",
      "event_type": "NEW_CISA",
      "event_time": "2026-05-27T09:00:00Z",
      "details": "CVE added to CISA Known Exploited Vulnerabilities"
    },
    {
      "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "cve": "CVE-2024-21887",
      "event_type": "NEW_CISA",
      "event_time": "2026-05-26T14:30:00Z",
      "details": "CVE added to CISA Known Exploited Vulnerabilities"
    }
  ],
  "generated_at": "2026-05-29T08:15:00Z"
}

The full JSON-RPC envelope, including _meta.precursor with request ID and credit details, is described in Response Format.

Errors

Code	Message	When
`-32602`	`invalid_params: event_type: pattern`	`event_type` contains characters outside `^[A-Za-z0-9_]+$`
`-32602`	`invalid_params: event_type: max:40`	`event_type` exceeds 40 characters
`-32602`	`invalid_params: days: min:1`	`days` is less than 1
`-32602`	`invalid_params: days: max:30`	`days` exceeds 30
`-32602`	`invalid_params: limit: min:1`	`limit` is less than 1
`-32602`	`invalid_params: limit: max:500`	`limit` exceeds 500
`-32001`	`unauthorized`	API key is invalid, revoked, or the request originates from a disallowed IP
`-32002`	`insufficient_credits`	Your organisation has no credits remaining

See Errors for the full error reference.