ContrastAPI is an MCP server published by com.contrastcyber, hosted at api.contrastcyber.com. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 40 tools, including health, cve_lookup, cve_lookup_bulk, cve_products, cve_search.
Monitor CVEs, packages, domains and IPs. CVE/EPSS/KEV, SBOM, DNS/TLS, IP lookups. No key, x402.
Nothing else in the archive shares these values.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
Database freshness: CVE/KEV/CWE counts and latest entries, and the sync state of each upstream feed. Costs no credits.
No parameters.
{
"name": "health",
"title": "Health and Data Freshness",
"description": "Database freshness: CVE/KEV/CWE counts and latest entries, and the sync state of each upstream feed. Costs no credits.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false
}
}Full CVE record by ID (CVSS, EPSS, KEV, CWE, references, CISA SSVC, Nuclei templates), with the optional GitHub Security Advisory. Call the cve_products tool for every affected product. If your SSVC level is unknown, read high.
| Parameter | Type | Description |
|---|---|---|
| cve_id * | string | CVE ID, e.g. CVE-2021-44228 |
| include_ghsa | boolean | Add the GitHub Security Advisory of the CVE, from the local copy of the GitHub Advisory Database |
{
"name": "cve_lookup",
"title": "CVE Lookup",
"description": "Full CVE record by ID (CVSS, EPSS, KEV, CWE, references, CISA SSVC, Nuclei templates), with the optional GitHub Security Advisory. Call the cve_products tool for every affected product. If your SSVC level is unknown, read high.",
"inputSchema": {
"type": "object",
"required": [
"cve_id"
],
"properties": {
"cve_id": {
"type": "string",
"maxLength": 24,
"description": "CVE ID, e.g. CVE-2021-44228"
},
"include_ghsa": {
"type": "boolean",
"description": "Add the GitHub Security Advisory of the CVE, from the local copy of the GitHub Advisory Database"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true
}
}Look up many CVEs at once, each with the fields of cve_lookup. Ids beyond the remaining credits come back in not_processed.
| Parameter | Type | Description |
|---|---|---|
| cve_ids * | array | CVE IDs |
{
"name": "cve_lookup_bulk",
"title": "Bulk CVE Lookup",
"description": "Look up many CVEs at once, each with the fields of cve_lookup. Ids beyond the remaining credits come back in not_processed.",
"inputSchema": {
"type": "object",
"required": [
"cve_ids"
],
"properties": {
"cve_ids": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 50,
"minItems": 1,
"description": "CVE IDs"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false
}
}The products a CVE affects, one page at a time, with the vulnerable products first. The vendor and product arguments keep only the products with that exact name. For the CVEs of one product, call cve_search.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Products per page |
| cve_id * | string | CVE ID, e.g. CVE-2021-44228 |
| offset | integer | Products to skip; pass next_offset of the previous page |
| vendor | string | Exact vendor name, as affected_products writes it |
| product | string | Exact product name, as affected_products writes it |
{
"name": "cve_products",
"title": "CVE Affected Products",
"description": "The products a CVE affects, one page at a time, with the vulnerable products first. The vendor and product arguments keep only the products with that exact name. For the CVEs of one product, call cve_search.",
"inputSchema": {
"type": "object",
"required": [
"cve_id"
],
"properties": {
"limit": {
"type": "integer",
"default": 20,
"maximum": 50,
"minimum": 1,
"description": "Products per page"
},
"cve_id": {
"type": "string",
"maxLength": 24,
"description": "CVE ID, e.g. CVE-2021-44228"
},
"offset": {
"type": "integer",
"default": 0,
"minimum": 0,
"description": "Products to skip; pass next_offset of the previous page"
},
"vendor": {
"type": "string",
"maxLength": 128,
"description": "Exact vendor name, as affected_products writes it"
},
"product": {
"type": "string",
"maxLength": 128,
"description": "Exact product name, as affected_products writes it"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false
}
}Search CVEs by severity, CWE, CVSS, EPSS, CISA KEV, ransomware use, Nuclei template, vendor, product and publish date, one page at a time. Call the cve_lookup tool for a full record, and the cpe_search tool to find the names.
| Parameter | Type | Description |
|---|---|---|
| sort | string | kev_date_added needs in_kev=true or kev_added_after |
| limit | integer | CVEs per page |
| cwe_id | string | e.g. CWE-79 |
| in_kev | boolean | true lists only CVEs in CISA KEV, false only CVEs not in it |
| offset | integer | CVEs to skip; pass next_offset of the previous page |
| vendor | string | Exact vendor name as cpe_search lists it, e.g. apache |
| product | string | Exact product name as cpe_search lists it, e.g. log4j |
| min_cvss | number | CVSS v3, or v4 when a CVE has no v3 |
| min_epss | number | Lowest EPSS score, a probability from 0 to 1, e.g. 0.1 |
| severity | string | CVSS severity: CRITICAL, HIGH, MEDIUM, LOW or NONE, from the v3 rating when the CVE has one |
List the CVEs most likely to be exploited, by EPSS score (the probability of exploitation in the next 30 days), with a verdict on the top score. To rank by composite risk score, call the cve_triage tool.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | How many CVEs to list, highest EPSS first |
| in_kev | boolean | true lists only CVEs in CISA KEV, false only CVEs not in it |
| vendor | string | Exact vendor name as cpe_search lists it, e.g. apache |
| product | string | Exact product name as cpe_search lists it, e.g. log4j |
| min_epss | number | Lowest EPSS score, a probability from 0 to 1, e.g. 0.1 |
| include_rejected | boolean | Also list the CVEs that NVD marks Rejected |
| known_ransomware | boolean | Only CVEs whose CISA KEV entry notes known ransomware use |
| has_nuclei_template | boolean | Only CVEs with a Nuclei detection template |
{
"name": "cve_leading",
"title": "Leading CVEs by EPSS",
"description": "List the CVEs most likely to be exploited, by EPSS score (the probability of exploitation in the next 30 days), with a verdict on the top score. To rank by composite risk score, call the cve_triage tool.",
"inputSchema": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 20,
"maximum": 50,
"minimum": 1,
"description": "How many CVEs to list, highest EPSS first"
},
"in_kev": {
"type": "boolean",
"description": "true lists only CVEs in CISA KEV, false only CVEs not in it"
},
"vendor": {
"type": "string",
"maxLength": 128,
"description": "Exact vendor name as cpe_search lists it, e.g. apache"
},
"product": {
"type": "string",
"maxLength": 128,
"description": "Exact product name as cpe_search lists it, e.g. log4j"
},
"min_epss": {
"type": "number",
"maximum": 1,
"minimum": 0,
"description": "Lowest EPSS score, a probability from 0 to 1, e.g. 0.1"
},
"include_rejected": {
"type": "boolean",
"description": "Also list the CVEs that NVD marks Rejected"
},
"known_ransomware": {
"type": "boolean",
"const": true,
"description": "Only CVEs whose CISA KEV entry notes known ransomware use"
},
"has_nuclei_template": {
"type": "boolean",
"const": true,
"description": "Only CVEs with a Nuclei detection template"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false
}
}CISA KEV catalog entry for a CVE: the required action, the patch deadline and known ransomware use. A CVE that CISA removed answers in_kev false, and one never listed answers "KEV entry not found".
| Parameter | Type | Description |
|---|---|---|
| cve_id * | string | CVE ID |
{
"name": "kev_lookup",
"title": "CISA KEV Lookup",
"description": "CISA KEV catalog entry for a CVE: the required action, the patch deadline and known ransomware use. A CVE that CISA removed answers in_kev false, and one never listed answers \"KEV entry not found\".",
"inputSchema": {
"type": "object",
"required": [
"cve_id"
],
"properties": {
"cve_id": {
"type": "string",
"maxLength": 24,
"description": "CVE ID"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false
}
}CWE weakness details (description, mitigations, examples, OWASP Top 10 category in 2021 and 2025), with how many CVEs and CISA KEV entries name it. To list them, call the cve_search tool with its cwe_id argument.
| Parameter | Type | Description |
|---|---|---|
| cwe_id * | string | CWE ID, e.g. CWE-79 |
{
"name": "cwe_lookup",
"title": "CWE Lookup",
"description": "CWE weakness details (description, mitigations, examples, OWASP Top 10 category in 2021 and 2025), with how many CVEs and CISA KEV entries name it. To list them, call the cve_search tool with its cwe_id argument.",
"inputSchema": {
"type": "object",
"required": [
"cwe_id"
],
"properties": {
"cwe_id": {
"type": "string",
"maxLength": 16,
"description": "CWE ID, e.g. CWE-79"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false
}
}Composite risk score of a CVE, 0-100, for patch priority. It reads EPSS, CISA KEV, Metasploit, CVSS, NVD and CNA exploit references, and ExploitDB. has_public_poc is null when no source names an exploit. For many CVEs, call cve_triage_bulk.
| Parameter | Type | Description |
|---|---|---|
| cve_id * | string | CVE ID |
{
"name": "cve_risk_score",
"title": "CVE Risk Score",
"description": "Composite risk score of a CVE, 0-100, for patch priority. It reads EPSS, CISA KEV, Metasploit, CVSS, NVD and CNA exploit references, and ExploitDB. has_public_poc is null when no source names an exploit. For many CVEs, call cve_triage_bulk.",
"inputSchema": {
"type": "object",
"required": [
"cve_id"
],
"properties": {
"cve_id": {
"type": "string",
"maxLength": 24,
"description": "CVE ID"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false
}
}Public exploit intelligence (GitHub PoCs, Metasploit, NVD and CNA exploit references, ExploitDB). GitHub PoC repositories are listed but not counted as proof of a public exploit. For a single patch-priority score, call cve_risk_score.
| Parameter | Type | Description |
|---|---|---|
| cve_id * | string | CVE ID |
{
"name": "cve_exploit",
"title": "CVE Exploit Intelligence",
"description": "Public exploit intelligence (GitHub PoCs, Metasploit, NVD and CNA exploit references, ExploitDB). GitHub PoC repositories are listed but not counted as proof of a public exploit. For a single patch-priority score, call cve_risk_score.",
"inputSchema": {
"type": "object",
"required": [
"cve_id"
],
"properties": {
"cve_id": {
"type": "string",
"maxLength": 24,
"description": "CVE ID"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false
}
}Rank the CVEs of a vendor or product by composite risk score, at or above the optional min_risk_score argument, as lean rows (cve_id, risk_score, label). Call the cve_lookup tool for detail, and the cpe_search tool to find the names.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | CVEs per page |
| offset | integer | CVEs to skip; pass next_offset of the previous page |
| vendor | string | Exact vendor name as cpe_search lists it, e.g. apache |
| product | string | Exact product name as cpe_search lists it, e.g. log4j |
| min_risk_score | number | Composite risk-score threshold |
| include_rejected | boolean | Also list the CVEs that NVD marks Rejected |
{
"name": "cve_triage",
"title": "CVE Triage",
"description": "Rank the CVEs of a vendor or product by composite risk score, at or above the optional min_risk_score argument, as lean rows (cve_id, risk_score, label). Call the cve_lookup tool for detail, and the cpe_search tool to find the names.",
"inputSchema": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1,
"description": "CVEs per page"
},
"offset": {
"type": "integer",
"default": 0,
"maximum": 10000,
"minimum": 0,
"description": "CVEs to skip; pass next_offset of the previous page"
},
"vendor": {
"type": "string",
"maxLength": 128,
"description": "Exact vendor name as cpe_search lists it, e.g. apache"
},
"product": {
"type": "string",
"maxLength": 128,
"description": "Exact product name as cpe_search lists it, e.g. log4j"
},
"min_risk_score": {
"type": "number",
"maximum": 100,
"minimum": 0,
"description": "Composite risk-score threshold"
},
"include_rejected": {
"type": "boolean",
"description": "Also list the CVEs that NVD marks Rejected"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false
}
}List the CVEs whose EPSS score rose most over the last 7 or 30 days, with the old and the new score. Filter by vendor, product, KEV state or a minimum score. Call the cve_lookup tool for the details of a CVE.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | CVEs per page |
| in_kev | boolean | true lists only CVEs in CISA KEV, false only CVEs not in it |
| offset | integer | CVEs to skip; pass next_offset of the previous page |
| vendor | string | Exact vendor name as cpe_search lists it, e.g. apache |
| product | string | Exact product name as cpe_search lists it, e.g. log4j |
| min_epss | number | Lowest current EPSS score to list, 0.0 to 1.0. |
| window_days | integer | Days to look back: 7 or 30. Default 7. |
{
"name": "epss_risers",
"title": "EPSS Risers",
"description": "List the CVEs whose EPSS score rose most over the last 7 or 30 days, with the old and the new score. Filter by vendor, product, KEV state or a minimum score. Call the cve_lookup tool for the details of a CVE.",
"inputSchema": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1,
"description": "CVEs per page"
},
"in_kev": {
"type": "boolean",
"description": "true lists only CVEs in CISA KEV, false only CVEs not in it"
},
"offset": {
"type": "integer",
"default": 0,
"maximum": 10000,
"minimum": 0,
"description": "CVEs to skip; pass next_offset of the previous page"
},
"vendor": {
"type": "string",
"maxLength": 128,
"description": "Exact vendor name as cpe_search lists it, e.g. apache"
},
"product": {
"type": "string",
"maxLength": 128,
"description": "Exact product name as cpe_search lists it, e.g. log4j"
},
"min_epss": {
"type": "number",
"maximum": 1,
"minimum": 0,
"description": "Lowest current EPSS score to list, 0.0 to 1.0."
},
"window_days": {
"type": "integer",
"default": 7,
"maximum": 30,
"minimum": 7,
"description": "Days to look back: 7 or 30. Default 7."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false
}
}Triage many CVEs at once, ranked by composite risk score. Ids beyond the remaining credits come back in not_processed.
| Parameter | Type | Description |
|---|---|---|
| cve_ids * | array | CVE IDs |
{
"name": "cve_triage_bulk",
"title": "Bulk CVE Triage",
"description": "Triage many CVEs at once, ranked by composite risk score. Ids beyond the remaining credits come back in not_processed.",
"inputSchema": {
"type": "object",
"required": [
"cve_ids"
],
"properties": {
"cve_ids": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 50,
"minItems": 1,
"description": "CVE IDs"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false
}
}CVE exposure of one vendor and product: severity, KEV and PoC counts, CVSS, EPSS, the worst risk score, the top CVEs and the endoflife.date support dates. To find the names, call the cpe_search tool.
| Parameter | Type | Description |
|---|---|---|
| vendor * | string | Exact vendor name as cpe_search lists it, e.g. apache |
| product * | string | Exact product name as cpe_search lists it, e.g. log4j |
| version | string | Product version, e.g. 22.21.1 or 11-24h2; picks the release cycle of eol |
| include_rejected | boolean | Also count and list the CVEs that NVD marks Rejected |
{
"name": "product_exposure",
"title": "Product Exposure",
"description": "CVE exposure of one vendor and product: severity, KEV and PoC counts, CVSS, EPSS, the worst risk score, the top CVEs and the endoflife.date support dates. To find the names, call the cpe_search tool.",
"inputSchema": {
"type": "object",
"required": [
"vendor",
"product"
],
"properties": {
"vendor": {
"type": "string",
"maxLength": 128,
"description": "Exact vendor name as cpe_search lists it, e.g. apache"
},
"product": {
"type": "string",
"maxLength": 128,
"description": "Exact product name as cpe_search lists it, e.g. log4j"
},
"version": {
"type": "string",
"maxLength": 128,
"description": "Product version, e.g. 22.21.1 or 11-24h2; picks the release cycle of eol"
},
"include_rejected": {
"type": "boolean",
"description": "Also count and list the CVEs that NVD marks Rejected"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false
}
}Find the CPE vendor and product names that hold a text, ranked by vulnerable CVE count. Pass a name with no % as it is to the vendor and product arguments of the cve_search, cve_triage, cve_leading, product_exposure and epss_risers tools.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Vendor and product pairs per page |
| offset | integer | Pairs to skip; pass next_offset of the previous page |
| search * | string | Text in vendor or product names, at least 3 bytes; case does not matter, and _ matches a space |
{
"name": "cpe_search",
"title": "CPE Search",
"description": "Find the CPE vendor and product names that hold a text, ranked by vulnerable CVE count. Pass a name with no % as it is to the vendor and product arguments of the cve_search, cve_triage, cve_leading, product_exposure and epss_risers tools.",
"inputSchema": {
"type": "object",
"required": [
"search"
],
"properties": {
"limit": {
"type": "integer",
"default": 20,
"maximum": 50,
"minimum": 1,
"description": "Vendor and product pairs per page"
},
"offset": {
"type": "integer",
"default": 0,
"maximum": 10000,
"minimum": 0,
"description": "Pairs to skip; pass next_offset of the previous page"
},
"search": {
"type": "string",
"maxLength": 128,
"description": "Text in vendor or product names, at least 3 bytes; case does not matter, and _ matches a space"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false
}
}Decode a CVSS v3.0/v3.1 vector into its base metrics and recompute its base, temporal and environmental scores. Use it on a vector you hold; cve_lookup already gives the scores of a CVE. v2 and v4 are refused.
| Parameter | Type | Description |
|---|---|---|
| vector * | string | CVSS:3.0/ or CVSS:3.1/ vector with all eight base metrics; temporal and environmental metrics are optional, e.g. CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:H |
{
"name": "cvss_calculator",
"title": "CVSS Calculator",
"description": "Decode a CVSS v3.0/v3.1 vector into its base metrics and recompute its base, temporal and environmental scores. Use it on a vector you hold; cve_lookup already gives the scores of a CVE. v2 and v4 are refused.",
"inputSchema": {
"type": "object",
"required": [
"vector"
],
"properties": {
"vector": {
"type": "string",
"maxLength": 127,
"description": "CVSS:3.0/ or CVSS:3.1/ vector with all eight base metrics; temporal and environmental metrics are optional, e.g. CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:H"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false
}
}Add, remove, list or clear the items this API key watches: CVEs, products, CVE searches, packages, domains and IP addresses. Read their changes with the watchlist_events tool. Requires a Pro API key.
| Parameter | Type | Description |
|---|---|---|
| name | string | Package name of a package_check item, e.g. lodash |
| clear | boolean | Deletes every item and the event cursor; takes no other argument |
| action | string | add or remove; leave out to list the items |
| cve_id | string | For a cve_lookup, kev_lookup or cve_exploit item, e.g. CVE-2021-44228 |
| cwe_id | string | cve_search items only, e.g. CWE-79 |
| domain | string | For a dns_lookup, ssl_check, whois_lookup, headers_check or cert_search item, such as example.com |
| in_kev | boolean | cve_search items only |
| vendor | string | Vendor, for a product_exposure or cve_search item |
| product | string | Product, for a product_exposure or cve_search item |
| version |
Report what changed on the items this API key watches, such as a new advisory for a package or a certificate about to expire, oldest first. A plain call continues where the last one stopped. Requires a Pro API key.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Most events per call; a shorter page with has_more true is not the end; repeat=true answers the whole last batch |
| cursor | string | next_cursor of an earlier answer; reads after it and keeps the position |
| repeat | boolean | Answers the last batch again; cannot be combined with cursor |
{
"name": "watchlist_events",
"title": "Monitoring Events",
"description": "Report what changed on the items this API key watches, such as a new advisory for a package or a certificate about to expire, oldest first. A plain call continues where the last one stopped. Requires a Pro API key.",
"inputSchema": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1,
"description": "Most events per call; a shorter page with has_more true is not the end; repeat=true answers the whole last batch"
},
"cursor": {
"type": "string",
"maxLength": 18,
"description": "next_cursor of an earlier answer; reads after it and keeps the position"
},
"repeat": {
"type": "boolean",
"const": true,
"description": "Answers the last batch again; cannot be combined with cursor"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}What this server keeps about the caller: the hash its credits are counted under, the rate limit left in this hour and the privacy policy. For a Pro key, which vendor keys are stored and a 15-minute link to change them.
No parameters.
{
"name": "privacy_my_data",
"title": "Privacy: My Data",
"description": "What this server keeps about the caller: the hash its credits are counted under, the rate limit left in this hour and the privacy policy. For a Pro key, which vendor keys are stored and a 15-minute link to change them.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false
}
}Save, delete or check your own Shodan and AbuseIPDB keys, which the ip_lookup tool uses. Needs a Pro API key or a manage link. The privacy_my_data tool gives a web link where a person can save the keys without the agent seeing them.
| Parameter | Type | Description |
|---|---|---|
| link | string | The 64 hex digits after #l= in a manage link; leave out to use this Pro API key |
| action * | string | apply saves or deletes keys; status reports the stored keys and needs link |
| shodan_key | string | a Shodan key to check and save |
| abuseipdb_key | string | an AbuseIPDB key to check and save |
| shodan_delete | boolean | deletes the stored Shodan key |
| abuseipdb_delete | boolean | deletes the stored AbuseIPDB key |
{
"name": "vendor_key_edit",
"title": "Vendor key edit",
"description": "Save, delete or check your own Shodan and AbuseIPDB keys, which the ip_lookup tool uses. Needs a Pro API key or a manage link. The privacy_my_data tool gives a web link where a person can save the keys without the agent seeing them.",
"inputSchema": {
"type": "object",
"required": [
"action"
],
"properties": {
"link": {
"type": "string",
"maxLength": 64,
"description": "The 64 hex digits after #l= in a manage link; leave out to use this Pro API key"
},
"action": {
"enum": [
"apply",
"status"
],
"type": "string",
"maxLength": 6,
"description": "apply saves or deletes keys; status reports the stored keys and needs link"
},
"shodan_key": {
"type": "string",
"maxLength": 128,
"description": "a Shodan key to check and save"
},
"abuseipdb_key": {
"type": "string",
"maxLength": 128,
"description": "an AbuseIPDB key to check and save"
},
"shodan_delete": {
"type": "boolean",
"const": true,
"description": "deletes the stored Shodan key"
},
"abuseipdb_delete": {
"type": "boolean",
"const": true,
"description": "deletes the stored AbuseIPDB key"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}Check a password's SHA-1 against Have I Been Pwned's Pwned Passwords list. It takes the full SHA-1, never the password. Only its first 5 hex digits leave this server.
| Parameter | Type | Description |
|---|---|---|
| sha1_hash * | string | SHA-1 of the password: 40 hex digits, either case |
{
"name": "password_check",
"title": "Breached Password Check",
"description": "Check a password's SHA-1 against Have I Been Pwned's Pwned Passwords list. It takes the full SHA-1, never the password. Only its first 5 hex digits leave this server.",
"inputSchema": {
"type": "object",
"required": [
"sha1_hash"
],
"properties": {
"sha1_hash": {
"type": "string",
"maxLength": 40,
"description": "SHA-1 of the password: 40 hex digits, either case"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true
}
}Look up a domain's DNS records: A, AAAA, MX, NS, TXT, CNAME, SOA and CAA. A record type the resolver could not answer is listed under unavailable.
| Parameter | Type | Description |
|---|---|---|
| domain * | string | Domain name, such as example.com |
{
"name": "dns_lookup",
"title": "DNS Lookup",
"description": "Look up a domain's DNS records: A, AAAA, MX, NS, TXT, CNAME, SOA and CAA. A record type the resolver could not answer is listed under unavailable.",
"inputSchema": {
"type": "object",
"required": [
"domain"
],
"properties": {
"domain": {
"type": "string",
"maxLength": 253,
"description": "Domain name, such as example.com"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true
}
}Check a host name for subdomain takeover through a dangling CNAME. takeover_possible is null when the CNAME points to a service whose DNS does not show whether the name can be claimed.
| Parameter | Type | Description |
|---|---|---|
| domain * | string | Host name, such as shop.example.com |
{
"name": "dns_takeover_check",
"title": "Subdomain Takeover Check",
"description": "Check a host name for subdomain takeover through a dangling CNAME. takeover_possible is null when the CNAME points to a service whose DNS does not show whether the name can be claimed.",
"inputSchema": {
"type": "object",
"required": [
"domain"
],
"properties": {
"domain": {
"type": "string",
"maxLength": 253,
"description": "Host name, such as shop.example.com"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true
}
}Check a domain's mail authentication: SPF, DMARC (from a parent domain when the domain has no record of its own), DKIM, MX and MTA-STS, each check with pass, warn or fail and a severity.
| Parameter | Type | Description |
|---|---|---|
| domain * | string | Domain name, such as example.com |
| dkim_selector | string | DKIM selector, such as google; without it the check tries the selectors of the domain's mail providers |
{
"name": "email_auth_check",
"title": "Email Authentication Check (SPF, DMARC, DKIM)",
"description": "Check a domain's mail authentication: SPF, DMARC (from a parent domain when the domain has no record of its own), DKIM, MX and MTA-STS, each check with pass, warn or fail and a severity.",
"inputSchema": {
"type": "object",
"required": [
"domain"
],
"properties": {
"domain": {
"type": "string",
"maxLength": 253,
"description": "Domain name, such as example.com"
},
"dkim_selector": {
"type": "string",
"maxLength": 238,
"description": "DKIM selector, such as google; without it the check tries the selectors of the domain's mail providers"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true
}
}Check an e-mail address without sending mail: whether its domain exists and takes mail, and whether a disposable domain list names it. It cannot tell whether the mailbox exists.
| Parameter | Type | Description |
|---|---|---|
| email * | string | E-mail address, such as name@example.com |
{
"name": "email_address_check",
"title": "Email Address Check",
"description": "Check an e-mail address without sending mail: whether its domain exists and takes mail, and whether a disposable domain list names it. It cannot tell whether the mailbox exists.",
"inputSchema": {
"type": "object",
"required": [
"email"
],
"properties": {
"email": {
"type": "string",
"maxLength": 254,
"description": "E-mail address, such as name@example.com"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true
}
}Check the TLS certificate and settings of a host name on port 443: version, cipher, trust, OCSP revocation, expiry, DNS names, the chain and an abuse.ch SSL Blacklist listing.
| Parameter | Type | Description |
|---|---|---|
| domain * | string | Host name, such as www.example.com |
{
"name": "ssl_check",
"title": "SSL/TLS Certificate Check",
"description": "Check the TLS certificate and settings of a host name on port 443: version, cipher, trust, OCSP revocation, expiry, DNS names, the chain and an abuse.ch SSL Blacklist listing.",
"inputSchema": {
"type": "object",
"required": [
"domain"
],
"properties": {
"domain": {
"type": "string",
"maxLength": 253,
"description": "Host name, such as www.example.com"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true
}
}Rate nine security headers of a web site, such as CSP, HSTS and Set-Cookie, from one GET to https://<domain>/ that follows up to 5 redirects on the same host or its www pair. Each finding that does not pass has a remediation.
| Parameter | Type | Description |
|---|---|---|
| domain * | string | Host name of the site, such as www.example.com |
| include_full_header_values | boolean | true sends each header value and URL whole, instead of cutting it after 500 code points |
{
"name": "headers_check",
"title": "Security Headers Check",
"description": "Rate nine security headers of a web site, such as CSP, HSTS and Set-Cookie, from one GET to https://<domain>/ that follows up to 5 redirects on the same host or its www pair. Each finding that does not pass has a remediation.",
"inputSchema": {
"type": "object",
"required": [
"domain"
],
"properties": {
"domain": {
"type": "string",
"maxLength": 253,
"description": "Host name of the site, such as www.example.com"
},
"include_full_header_values": {
"type": "boolean",
"description": "true sends each header value and URL whole, instead of cutting it after 500 code points"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true
}
}Read robots.txt of https://<domain> and, if it allows us, /.well-known/security.txt, with up to 5 redirects on the host or its www pair. Gives the rules that bind us, sitemaps, fields such as Contact and Expires, and RFC 9309/9116 issues.
| Parameter | Type | Description |
|---|---|---|
| domain * | string | Host name of the site, such as www.example.com |
{
"name": "well_known",
"title": "Robots.txt and security.txt Check",
"description": "Read robots.txt of https://<domain> and, if it allows us, /.well-known/security.txt, with up to 5 redirects on the host or its www pair. Gives the rules that bind us, sitemaps, fields such as Contact and Expires, and RFC 9309/9116 issues.",
"inputSchema": {
"type": "object",
"required": [
"domain"
],
"properties": {
"domain": {
"type": "string",
"maxLength": 253,
"description": "Host name of the site, such as www.example.com"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true
}
}Follow an http or https URL's redirects, up to 10 requests on ports 80 and 443. Lists each hop and status, the final URL, the stop reason and any https to http step. Reads no body; no HTML or JavaScript redirect. Location text is untrusted.
| Parameter | Type | Description |
|---|---|---|
| url * | string | The http or https URL to follow; REST takes it percent-encoded |
{
"name": "redirect_chain",
"title": "Redirect Chain Check",
"description": "Follow an http or https URL's redirects, up to 10 requests on ports 80 and 443. Lists each hop and status, the final URL, the stop reason and any https to http step. Reads no body; no HTML or JavaScript redirect. Location text is untrusted.",
"inputSchema": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"maxLength": 4096,
"description": "The http or https URL to follow; REST takes it percent-encoded"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true
}
}Look up a domain's registration over RDAP, or WHOIS where allowed: registrar, dates, status, name servers and DNSSEC. A name under a registered domain asks about that domain. No registrant data.
| Parameter | Type | Description |
|---|---|---|
| domain * | string | Domain name, such as example.com; www.example.com asks about example.com |
{
"name": "whois_lookup",
"title": "WHOIS / RDAP Lookup",
"description": "Look up a domain's registration over RDAP, or WHOIS where allowed: registrar, dates, status, name servers and DNSSEC. A name under a registered domain asks about that domain. No registrant data.",
"inputSchema": {
"type": "object",
"required": [
"domain"
],
"properties": {
"domain": {
"type": "string",
"maxLength": 253,
"description": "Domain name, such as example.com; www.example.com asks about example.com"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true
}
}List when the Wayback Machine captured a host's home page: the first and last capture, the years between them (archive span, not domain age) and the latest 10 captures with links.
| Parameter | Type | Description |
|---|---|---|
| domain * | string | Host name, such as example.com |
{
"name": "wayback_lookup",
"title": "Wayback Machine Lookup",
"description": "List when the Wayback Machine captured a host's home page: the first and last capture, the years between them (archive span, not domain age) and the latest 10 captures with links.",
"inputSchema": {
"type": "object",
"required": [
"domain"
],
"properties": {
"domain": {
"type": "string",
"maxLength": 253,
"description": "Host name, such as example.com"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true
}
}List the unexpired certificates that Certificate Transparency logs hold for a host name, wildcards included, from SSLMate's Cert Spotter: the 10 newest, with issuer, validity and DNS names. Costs 2 credits.
| Parameter | Type | Description |
|---|---|---|
| domain * | string | Host name, such as example.com or www.example.com |
{
"name": "cert_search",
"title": "Certificate Transparency Search",
"description": "List the unexpired certificates that Certificate Transparency logs hold for a host name, wildcards included, from SSLMate's Cert Spotter: the 10 newest, with issuer, validity and DNS names. Costs 2 credits.",
"inputSchema": {
"type": "object",
"required": [
"domain"
],
"properties": {
"domain": {
"type": "string",
"maxLength": 253,
"description": "Host name, such as example.com or www.example.com"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true
}
}List up to 50 subdomains of a registrable domain from Certificate Transparency, DNS queries for 94 common names and the domain's MX, NS and SPF records. Costs 2 credits.
| Parameter | Type | Description |
|---|---|---|
| domain * | string | Domain name, such as example.com; www.example.com asks about example.com |
{
"name": "subdomain_enum",
"title": "Subdomain Enumeration",
"description": "List up to 50 subdomains of a registrable domain from Certificate Transparency, DNS queries for 94 common names and the domain's MX, NS and SPF records. Costs 2 credits.",
"inputSchema": {
"type": "object",
"required": [
"domain"
],
"properties": {
"domain": {
"type": "string",
"maxLength": 253,
"description": "Domain name, such as example.com; www.example.com asks about example.com"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true
}
}Look up a public IP: AS, country, cloud provider, CDN, datacenter, Tor exit, crawler, DROP listing and PTR name. A Pro key with its own Shodan or AbuseIPDB key adds exposure and reputation. For every prefix of the AS, call asn_lookup.
| Parameter | Type | Description |
|---|---|---|
| ip_address * | string | Public IPv4 or IPv6 address, such as 8.8.8.8 or 2001:4860:4860::8888 |
{
"name": "ip_lookup",
"title": "IP Lookup",
"description": "Look up a public IP: AS, country, cloud provider, CDN, datacenter, Tor exit, crawler, DROP listing and PTR name. A Pro key with its own Shodan or AbuseIPDB key adds exposure and reputation. For every prefix of the AS, call asn_lookup.",
"inputSchema": {
"type": "object",
"required": [
"ip_address"
],
"properties": {
"ip_address": {
"type": "string",
"maxLength": 45,
"description": "Public IPv4 or IPv6 address, such as 8.8.8.8 or 2001:4860:4860::8888"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true
}
}Look up an autonomous system by number, such as AS15169, or by an IP address it holds: name, country and one page of its IPv4 and IPv6 prefixes, derived from IPtoASN.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Prefixes per page, in each address family |
| offset | integer | Prefixes to skip in each family; pass next_offset of the previous page |
| target * | string | AS number, such as AS15169 or 15169, or a public IPv4 or IPv6 address, such as 8.8.8.8 |
{
"name": "asn_lookup",
"title": "ASN Lookup",
"description": "Look up an autonomous system by number, such as AS15169, or by an IP address it holds: name, country and one page of its IPv4 and IPv6 prefixes, derived from IPtoASN.",
"inputSchema": {
"type": "object",
"required": [
"target"
],
"properties": {
"limit": {
"type": "integer",
"default": 50,
"maximum": 50,
"minimum": 1,
"description": "Prefixes per page, in each address family"
},
"offset": {
"type": "integer",
"default": 0,
"minimum": 0,
"description": "Prefixes to skip in each family; pass next_offset of the previous page"
},
"target": {
"type": "string",
"maxLength": 45,
"description": "AS number, such as AS15169 or 15169, or a public IPv4 or IPv6 address, such as 8.8.8.8"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false
}
}MITRE D3FEND defenses that counter a MITRE ATT&CK technique. A technique id such as T1055 also matches its sub-techniques. Source: MITRE D3FEND (MIT license).
| Parameter | Type | Description |
|---|---|---|
| attack_technique_id * | string | MITRE ATT&CK technique id in upper case, e.g. T1055 or T1055.012 |
{
"name": "d3fend_for_attack",
"title": "D3FEND Defenses for ATT&CK",
"description": "MITRE D3FEND defenses that counter a MITRE ATT&CK technique. A technique id such as T1055 also matches its sub-techniques. Source: MITRE D3FEND (MIT license).",
"inputSchema": {
"type": "object",
"required": [
"attack_technique_id"
],
"properties": {
"attack_technique_id": {
"type": "string",
"maxLength": 9,
"description": "MITRE ATT&CK technique id in upper case, e.g. T1055 or T1055.012"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false
}
}Look up a Windows driver hash in the LOLDrivers catalog of vulnerable and malicious drivers. Block on the file and Authenticode hashes, not on the detection rules. For many hashes, call driver_lookup_bulk. Source: LOLDrivers (Apache-2.0).
| Parameter | Type | Description |
|---|---|---|
| file_hash * | string | MD5, SHA1 or SHA256 of the driver file, or its Authentihash: 32, 40 or 64 hex digits, either case |
| include_commands | boolean | true adds the catalog's command text to each match |
{
"name": "driver_lookup",
"title": "Windows Driver Lookup (LOLDrivers)",
"description": "Look up a Windows driver hash in the LOLDrivers catalog of vulnerable and malicious drivers. Block on the file and Authenticode hashes, not on the detection rules. For many hashes, call driver_lookup_bulk. Source: LOLDrivers (Apache-2.0).",
"inputSchema": {
"type": "object",
"required": [
"file_hash"
],
"properties": {
"file_hash": {
"type": "string",
"maxLength": 64,
"description": "MD5, SHA1 or SHA256 of the driver file, or its Authentihash: 32, 40 or 64 hex digits, either case"
},
"include_commands": {
"type": "boolean",
"description": "true adds the catalog's command text to each match"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false
}
}Look up many driver file hashes in the LOLDrivers catalog at once, each with the fields of driver_lookup. Hashes beyond the remaining credits come back in not_processed.
| Parameter | Type | Description |
|---|---|---|
| hashes * | array | MD5, SHA1 or SHA256 of driver files or of their Authentihash |
{
"name": "driver_lookup_bulk",
"title": "Bulk Windows Driver Lookup",
"description": "Look up many driver file hashes in the LOLDrivers catalog at once, each with the fields of driver_lookup. Hashes beyond the remaining credits come back in not_processed.",
"inputSchema": {
"type": "object",
"required": [
"hashes"
],
"properties": {
"hashes": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 20,
"minItems": 1,
"description": "MD5, SHA1 or SHA256 of driver files or of their Authentihash"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false
}
}Check a package against the OSV.dev advisories (GitHub, Go, PyPA, RustSec) and the OpenSSF malicious package list, with the fixed version and endoflife.date dates. For severity, pass the CVE aliases to the cve_triage_bulk tool.
| Parameter | Type | Description |
|---|---|---|
| name * | string | Package name as the dependency file writes it, e.g. lodash, @babel/core, org.apache.logging.log4j:log4j-core, golang.org/x/net |
| limit | integer | Results per page |
| offset | integer | Results to skip; pass next_offset of the previous page |
| version | string | Exact version, e.g. 4.17.20; without it every result is listed |
| ecosystem * | string | npm, PyPI, Maven, Go, NuGet, RubyGems, crates.io, Packagist or SwiftURL. Case does not matter. |
{
"name": "package_check",
"title": "Package Vulnerability Check",
"description": "Check a package against the OSV.dev advisories (GitHub, Go, PyPA, RustSec) and the OpenSSF malicious package list, with the fixed version and endoflife.date dates. For severity, pass the CVE aliases to the cve_triage_bulk tool.",
"inputSchema": {
"type": "object",
"required": [
"ecosystem",
"name"
],
"properties": {
"name": {
"type": "string",
"maxLength": 256,
"description": "Package name as the dependency file writes it, e.g. lodash, @babel/core, org.apache.logging.log4j:log4j-core, golang.org/x/net"
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 50,
"minimum": 1,
"description": "Results per page"
},
"offset": {
"type": "integer",
"default": 0,
"minimum": 0,
"description": "Results to skip; pass next_offset of the previous page"
},
"version": {
"type": "string",
"maxLength": 128,
"description": "Exact version, e.g. 4.17.20; without it every result is listed"
},
"ecosystem": {
"type": "string",
"maxLength": 16,
"description": "npm, PyPI, Maven, Go, NuGet, RubyGems, crates.io, Packagist or SwiftURL. Case does not matter."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false
}
}Check many packages at once, each an ecosystem, a name and an exact version, against the advisories package_check reads. For the summary and ranges of an advisory, call the package_check tool.
| Parameter | Type | Description |
|---|---|---|
| items * | array | Packages, each with its ecosystem, name and exact version |
{
"name": "package_check_bulk",
"title": "Bulk Package Check (SBOM)",
"description": "Check many packages at once, each an ecosystem, a name and an exact version, against the advisories package_check reads. For the summary and ranges of an advisory, call the package_check tool.",
"inputSchema": {
"type": "object",
"required": [
"items"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"ecosystem",
"name",
"version"
],
"properties": {
"name": {
"type": "string"
},
"version": {
"type": "string"
},
"ecosystem": {
"type": "string"
}
},
"additionalProperties": false
},
"maxItems": 500,
"minItems": 1,
"description": "Packages, each with its ecosystem, name and exact version"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false
}
}ContrastAPI is a security data and monitoring server, with watchlists of CVEs, packages, domains and IP addresses. Call cve_lookup for a CVE, package_check for a package, dns_lookup for a domain and ip_lookup for an IP address. Call watchlist_edit and watchlist_events for monitoring, which needs an API key. A Pro API key is sold at https://api.contrastcyber.com/pricing. It looks up, searches and scores CVE, KEV and CWE records. It gives public exploit intelligence. It decodes and scores a CVSS v3 vector. It checks a password's SHA-1 against Have I Been Pwned. It reads a domain's DNS records and checks a host name for a dangling CNAME. It checks a domain's SPF, DMARC, DKIM and MTA-STS records. It checks whether an e-mail address's domain takes mail and whether the address is disposable. It checks the TLS certificate and settings of a host name and rates the security headers of a web site. It reads the robots.txt and the security.txt of a web site. It looks up the registration of a domain name over RDAP or WHOIS. It lists the Wayback Machine captures of a host name. It lists the unexpired certificates that Certificate Transparency logs hold for a host name. It lists the subdomains of a registrable domain from Certificate Transparency and DNS. It names the MITRE D3FEND defenses that counter a MITRE ATT&CK technique. It finds a driver file hash in the LOLDrivers catalog. It looks up the AS, the country, the cloud range, the Tor exit, the crawler range and the DROP listing of a public IP address. It looks up an AS by its number or by an address it holds. It checks a package or a list of packages of nine ecosystems against OSV.dev advisories and malicious packages. It gives the end-of-life dates of a product or a package from endoflife.date. The watchlist keeps CVE, package, domain and IP items for an API key, and watchlist_events reads their change events. A Pro API key can save its own Shodan and AbuseIPDB keys with vendor_key_edit, and ip_lookup then adds their answers. It says what it keeps about the caller. It follows the redirect chain of a URL and lists each hop. A call with no API key and no credits left can pay per call with x402 in USDC on Solana.
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
| kev_added_after |
| string |
| YYYY-MM-DD; only CVEs added to CISA KEV on or after this date and still in it |
| published_after | string | YYYY-MM-DD |
| include_rejected | boolean | Also list the CVEs that NVD marks Rejected |
| known_ransomware | boolean | Only CVEs whose CISA KEV entry notes known ransomware use |
| published_before | string | YYYY-MM-DD |
| has_nuclei_template | boolean | Only CVEs with a Nuclei detection template |
{
"name": "cve_search",
"title": "CVE Search",
"description": "Search CVEs by severity, CWE, CVSS, EPSS, CISA KEV, ransomware use, Nuclei template, vendor, product and publish date, one page at a time. Call the cve_lookup tool for a full record, and the cpe_search tool to find the names.",
"inputSchema": {
"type": "object",
"properties": {
"sort": {
"enum": [
"published_time",
"epss",
"cvss",
"kev_date_added"
],
"type": "string",
"maxLength": 15,
"description": "kev_date_added needs in_kev=true or kev_added_after"
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1,
"description": "CVEs per page"
},
"cwe_id": {
"type": "string",
"maxLength": 16,
"description": "e.g. CWE-79"
},
"in_kev": {
"type": "boolean",
"description": "true lists only CVEs in CISA KEV, false only CVEs not in it"
},
"offset": {
"type": "integer",
"default": 0,
"maximum": 10000,
"minimum": 0,
"description": "CVEs to skip; pass next_offset of the previous page"
},
"vendor": {
"type": "string",
"maxLength": 128,
"description": "Exact vendor name as cpe_search lists it, e.g. apache"
},
"product": {
"type": "string",
"maxLength": 128,
"description": "Exact product name as cpe_search lists it, e.g. log4j"
},
"min_cvss": {
"type": "number",
"maximum": 10,
"minimum": 0,
"description": "CVSS v3, or v4 when a CVE has no v3"
},
"min_epss": {
"type": "number",
"maximum": 1,
"minimum": 0,
"description": "Lowest EPSS score, a probability from 0 to 1, e.g. 0.1"
},
"severity": {
"enum": [
"CRITICAL",
"HIGH",
"MEDIUM",
"LOW",
"NONE"
],
"type": "string",
"maxLength": 16,
"description": "CVSS severity: CRITICAL, HIGH, MEDIUM, LOW or NONE, from the v3 rating when the CVE has one"
},
"kev_added_after": {
"type": "string",
"maxLength": 31,
"description": "YYYY-MM-DD; only CVEs added to CISA KEV on or after this date and still in it"
},
"published_after": {
"type": "string",
"maxLength": 31,
"description": "YYYY-MM-DD"
},
"include_rejected": {
"type": "boolean",
"description": "Also list the CVEs that NVD marks Rejected"
},
"known_ransomware": {
"type": "boolean",
"const": true,
"description": "Only CVEs whose CISA KEV entry notes known ransomware use"
},
"published_before": {
"type": "string",
"maxLength": 31,
"description": "YYYY-MM-DD"
},
"has_nuclei_template": {
"type": "boolean",
"const": true,
"description": "Only CVEs with a Nuclei detection template"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false
}
}| string |
| Exact version of a product_exposure or package_check item; leave out to watch every version |
| endpoint | string | The tool the item watches |
| min_cvss | number | CVSS v3, or v4 when a CVE has no v3; cve_search items only |
| min_epss | number | At most three decimals; cve_search items only |
| packages | array | package_check items, each with an ecosystem, a name and an optional version |
| severity | string | cve_search items only |
| ecosystem | string | For a package_check item: npm, PyPI, Maven, Go, NuGet, RubyGems, crates.io, Packagist or SwiftURL |
| ip_address | string | Public IPv4 or IPv6 address of an ip_lookup item, such as 8.8.8.8, no prefix |
| known_ransomware | boolean | cve_search items only |
| has_nuclei_template | boolean | cve_search items only |
{
"name": "watchlist_edit",
"title": "Watchlist: CVE, Package, Domain and IP Monitoring",
"description": "Add, remove, list or clear the items this API key watches: CVEs, products, CVE searches, packages, domains and IP addresses. Read their changes with the watchlist_events tool. Requires a Pro API key.",
"inputSchema": {
"type": "object",
"properties": {
"name": {
"type": "string",
"maxLength": 256,
"description": "Package name of a package_check item, e.g. lodash"
},
"clear": {
"type": "boolean",
"const": true,
"description": "Deletes every item and the event cursor; takes no other argument"
},
"action": {
"enum": [
"add",
"remove"
],
"type": "string",
"maxLength": 8,
"description": "add or remove; leave out to list the items"
},
"cve_id": {
"type": "string",
"maxLength": 24,
"description": "For a cve_lookup, kev_lookup or cve_exploit item, e.g. CVE-2021-44228"
},
"cwe_id": {
"type": "string",
"maxLength": 16,
"description": "cve_search items only, e.g. CWE-79"
},
"domain": {
"type": "string",
"maxLength": 253,
"description": "For a dns_lookup, ssl_check, whois_lookup, headers_check or cert_search item, such as example.com"
},
"in_kev": {
"type": "boolean",
"description": "cve_search items only"
},
"vendor": {
"type": "string",
"maxLength": 128,
"description": "Vendor, for a product_exposure or cve_search item"
},
"product": {
"type": "string",
"maxLength": 128,
"description": "Product, for a product_exposure or cve_search item"
},
"version": {
"type": "string",
"maxLength": 128,
"description": "Exact version of a product_exposure or package_check item; leave out to watch every version"
},
"endpoint": {
"enum": [
"cve_lookup",
"kev_lookup",
"cve_exploit",
"product_exposure",
"cve_search",
"dns_lookup",
"ssl_check",
"whois_lookup",
"headers_check",
"cert_search",
"package_check",
"ip_lookup"
],
"type": "string",
"maxLength": 16,
"description": "The tool the item watches"
},
"min_cvss": {
"type": "number",
"maximum": 10,
"minimum": 0,
"description": "CVSS v3, or v4 when a CVE has no v3; cve_search items only"
},
"min_epss": {
"type": "number",
"maximum": 1,
"minimum": 0,
"description": "At most three decimals; cve_search items only"
},
"packages": {
"type": "array",
"items": {
"type": "object",
"required": [
"ecosystem",
"name"
],
"properties": {
"name": {
"type": "string"
},
"version": {
"type": "string"
},
"ecosystem": {
"type": "string"
}
},
"additionalProperties": false
},
"maxItems": 500,
"minItems": 1,
"description": "package_check items, each with an ecosystem, a name and an optional version"
},
"severity": {
"enum": [
"CRITICAL",
"HIGH",
"MEDIUM",
"LOW",
"NONE"
],
"type": "string",
"maxLength": 16,
"description": "cve_search items only"
},
"ecosystem": {
"type": "string",
"maxLength": 16,
"description": "For a package_check item: npm, PyPI, Maven, Go, NuGet, RubyGems, crates.io, Packagist or SwiftURL"
},
"ip_address": {
"type": "string",
"maxLength": 45,
"description": "Public IPv4 or IPv6 address of an ip_lookup item, such as 8.8.8.8, no prefix"
},
"known_ransomware": {
"type": "boolean",
"const": true,
"description": "cve_search items only"
},
"has_nuclei_template": {
"type": "boolean",
"const": true,
"description": "cve_search items only"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}