cisa_search_ics_advisories
cisa_search_ics_advisoriesSearch the CISA industrial control system advisory corpus — every CSAF 2.0 advisory covering PLC, HMI, SCADA, building-automation, and medical-device products from 2010 onward. Filter by vendor, product, CVE, CWE, CVSS range, severity band, critical-infrastructure sector, advisory series, publication date, revision date, or whether an advisory covers a CVE in the CISA Known Exploited Vulnerabilities catalog, and run full-text search over advisory titles, vendor and product names, and originating vendor advisory reference summaries. Sector filtering reaches only advisories that carry a sector note, which begins in 2017; the response reports how many documents a sector filter can never match. Returns advisory IDs for cisa_get_advisory, the CVEs each advisory covers and which of them are in KEV, and the source URL and attribution every advisory response carries.
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": "cisa_search_ics_advisories"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Full-text search over advisory titles, vendor and product names, and originating vendor advisory reference summaries. Tokens are AND-combined; FTS5 operators in the input are neutralized rather than honored, and a token with no letter or digit is ignored. Needs at least one word or number. | |
| cve | No | Exact CVE membership, e.g. CVE-2021-44228. Case and surrounding whitespace are normalized. | |
| cwe | No | Exact CWE identifier, e.g. CWE-787, matched against every vulnerability entry in the advisory. Case and surrounding whitespace are normalized. A parent class does not match its children. | |
| inKev | No | true selects advisories covering at least one CVE in the CISA Known Exploited Vulnerabilities catalog; false selects advisories covering none. Checked against every CVE an advisory covers, not only the twenty listed per result. | |
| limit | No | Maximum advisories per page; requests above 50 use 50 when input clamping is enabled. | |
| order | No | Sort direction. Under relevance, desc means most relevant first. | desc |
| cursor | No | Opaque pagination cursor from a previous call. Omit for the first page. | |
| sector | No | Critical-infrastructure sector, matched against the normalized sector set. Multiple is the sentinel the corpus uses for an advisory affecting many sectors. | |
| series | No | Advisory series: ICSA industrial control system advisories, or ICSMA medical-device advisories, a small minority of the corpus. | |
| sortBy | No | Field to sort by. relevance requires q and ranks by FTS5 bm25. | revised |
| vendor | No | Case-insensitive literal substring of a vendor label. Surrounding whitespace is trimmed before the two-character minimum. Vendor names are unnormalized upstream — the same company can appear under several spellings. | |
| cvssMax | No | Maximum value of the advisory's maximum CVSS base score, inclusive. | |
| cvssMin | No | Minimum value of the advisory's maximum CVSS base score, inclusive. | |
| product | No | Case-insensitive literal substring of a product name. Surrounding whitespace is trimmed before the two-character minimum. | |
| severity | No | Severity band of the advisory's maximum CVSS score. | |
| publisher | No | coordinator selects CISA-authored advisories; other selects vendor advisories CISA republished, over a quarter of the corpus. | |
| revisedTo | No | Latest current release date, inclusive, YYYY-MM-DD. | |
| publishedTo | No | Latest initial release date, inclusive, YYYY-MM-DD. | |
| revisedFrom | No | Earliest current release date, inclusive, YYYY-MM-DD. | |
| publishedFrom | No | Earliest initial release date, inclusive, YYYY-MM-DD. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cap | No | The page limit that was applied. | |
| error | No | Present when the call failed. Absent on success. | |
| shown | No | Advisories returned on this page. | |
| cursor | No | Opaque cursor for the next page. Absent when this is the last page. | |
| mirror | No | Which index state answered this call. | |
| notice | No | Guidance when nothing matched — the filter that matches no advisory on its own and what dropping it restores, or the filters whose removal restores results and how many — when a page was capped, when KEV membership was not evaluated, or when a cwe result may be incomplete. | |
| hasMore | No | Whether more matches exist beyond this page. | |
| results | No | Matching advisories for this page. | |
| truncated | No | True when the page limit capped this result. | |
| totalCount | No | Total matches before paging. | |
| cvssCoverage | No | Disclosure of derived-band and no-score coverage under a score filter. | |
| appliedFilters | No | The filters the server actually applied. | |
| sectorCoverage | No | Disclosure of how many advisories a sector filter can never match. |