Epss Query Threshold
epss_query_thresholdDiscover CVEs using inclusive EPSS or percentile bounds, CVE year or dataset-addition recency; filters intersect and at least one is required. Examine one candidate page in the upstream FIRST order, which is not ranked by EPSS, so the first page does not hold the highest scores. Each serialized response surface fits 65536 UTF-8 bytes; budgetLimited and withheldCount disclose whole matches withheld, with nextOffset at the first withheld match. Year filtering can return an empty page with nextOffset; candidateTotal is a broad-query total, not an exact-year total. Continue with the same filters, limit, returned score date and nextOffset.
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": "epss_query_threshold"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| date | No | UTC date YYYY-MM-DD from 2021-04-14 through today; omitted or blank selects latest available data. | |
| year | No | Exact CVE year from 1999 through the current UTC year; candidate pages may contain no matches. | |
| limit | No | Requested candidates per page; positive safe integers above 10000 are clamped to 10000 before exact-year filtering. | |
| offset | No | Candidate-space offset; use returned nextOffset for continuation. | |
| maxEpss | No | Inclusive maximum EPSS probability. | |
| minEpss | No | Inclusive minimum EPSS probability. | |
| maxPercentile | No | Inclusive maximum population percentile rank. | |
| minPercentile | No | Inclusive minimum population percentile rank. | |
| addedWithinDays | No | Dataset-addition recency relative to upstream present, independent of historical date. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| error | No | Present when the call failed. Absent on success. | |
| notice | No | Missing-data, deferred-work or model-metadata caveats. | |
| scores | No | Retained records from this candidate page. | |
| filters | No | Applied filters; combine with provenance scoreDates to pin continuation. | |
| pagination | No | Candidate pagination accounting. | |
| provenance | No | Snapshot source and model metadata, including dates from filtered-out candidates. |