Epss Get Scores
epss_get_scoresRetrieve latest available or historically dated FIRST EPSS probability and percentile for supplied CVEs. Process up to 500 unique entries from batchOffset; response byte limits can return fewer whole entries. Resume with nextBatchOffset as batchOffset, the original cves and returned score date as date. deferredCves were not queried; withheldCves were processed but omitted, and either list can be a declared preview. Missing scores remain unknown; use epss_list_reference for coverage and interpretation.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"cves": "<cves>"
},
"name": "epss_get_scores"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cves | Yes | One to 5000 CVE identifiers; whitespace, comma or semicolon-delimited strings are also accepted. | |
| date | No | UTC date YYYY-MM-DD from 2021-04-14 through today; omitted or blank selects latest available data. | |
| batchOffset | No | Resume in first-occurrence normalized unique input order; resubmit the original cves, returned score date and original policy/severity inputs. |
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 | Forecasts ordered by EPSS descending then CVE. | |
| provenance | No | Source and model attribution. | |
| batchOffset | No | Starting offset in the original normalized unique input. | |
| deferredCves | No | Never-queried identifiers beyond this call workload cap; complete unless deferredCvesComplete is false. Resume using nextBatchOffset and the original submission. | |
| unscoredCves | No | Retained processed identifiers without scores, in request order. | |
| withheldCves | No | Already processed identifiers withheld by the byte budget, in original input order; may be a preview. | |
| budgetLimited | No | True when whole entries or accounting lists were shortened to fit the serialized response budget. | |
| deferredCount | No | Identifiers beyond this call workload cap, not queried. | |
| returnedCount | No | Processed identifiers whose complete score, history or unscored entry is included. | |
| withheldCount | No | Processed identifiers withheld by the response byte budget; queried valid entries are included in processedCount. | |
| duplicateCount | No | Duplicate submitted entries removed. | |
| processedCount | No | Unique identifiers processed, including invalid formats. | |
| requestedCount | No | Unique normalized identifiers submitted. | |
| nextBatchOffset | No | Resume with this batchOffset and the original cves, returned date and original severity/policy inputs. | |
| deferredCvesComplete | No | True when deferredCves includes every never-queried deferred identifier. | |
| withheldCvesComplete | No | True when withheldCves includes every withheld identifier. |