io.github.cyanheads/nist-nvd-mcp-server
NPM · @CYANHEADS/NIST-NVD-MCP-SERVER · SCANNED AUG 7
Search and audit NIST NVD CVEs by keyword, severity, CWE, CISA KEV status, and CPE.
Available components
How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score →
Supply Chain Security98
- No malware found by supply-chain analysis.Pass
- No known CVEs affecting this package version or its production dependencies.Pass
- No install/post-install scripts declared.Pass
- 40 of 127 dependencies flagged as unhealthy. View diagnostics → Partial
Provenance & Transparency45
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
- Clear OSI-approved license (Apache-2.0).Pass
- Actively maintained (last published 6 days ago).Pass
- Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail
Schema Quality & AI Usability60
- AI-judged instruction clarity (excellent).Pass
- Context-footprint check failed: tool/resource definitions use about 1999 tokens (~399/item across 5 items; 5 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management0
- Stability not yet verified: not enough scan history yet (needs a 30-day window).Unverified
Tool Coverage100
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 100% of tool parameters carry a description.Pass
- Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Unverified: 1 category
A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.
Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.
npm · @cyanheads/nist-nvd-mcp-server
claude mcp add cyanheads-nist-nvd-mcp-server -- npx -y @cyanheads/nist-nvd-mcp-server
codex mcp add cyanheads-nist-nvd-mcp-server -- npx -y @cyanheads/nist-nvd-mcp-server
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"cyanheads-nist-nvd-mcp-server": {
"type": "local",
"command": [
"npx",
"-y",
"@cyanheads/nist-nvd-mcp-server"
],
"enabled": true
}
}
} openclaw mcp add cyanheads-nist-nvd-mcp-server --command npx --arg -y --arg @cyanheads/nist-nvd-mcp-server
mcp_servers:
cyanheads-nist-nvd-mcp-server:
command: "npx"
args: ["-y", "@cyanheads/nist-nvd-mcp-server"] {
"mcpServers": {
"cyanheads-nist-nvd-mcp-server": {
"command": "npx",
"args": [
"-y",
"@cyanheads/nist-nvd-mcp-server"
]
}
}
} Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 7 Aug 26 +3
- Known CVEs: partial → pass ▲ security
- Dependency health: partial → 0.85 functional
- 6 Aug 26 +27
- Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window). security
- MCP protocol: unverified → pass ▲ functional
- Tool coverage: unverified → 100 ▲ functional
- First check of Tool coverage: 100 functional
- First check of Schema quality: fail functional
- First check of Schema quality: excellent functional
- First check of Schema quality: fail functional
- First check of Tool coverage: 100 functional
- 5 Aug 26 +1
- CVE-2026-69207 no longer affects this package ▲ security
- Known CVEs: fail → partial ▲ security
- 4 Aug 26 −1
- CVE-2026-69207 affects this package: medium ▼ security
- Known CVEs: partial → fail ▼ security
- 2 Aug 26 +29
- Provenance: unverified → fail ▼ security
- GHSA-frvp-7c67-39w9 no longer affects this package ▲ security
- Install scripts: unverified → pass ▲ security
- Known CVEs: unverified → partial ▲ security
- Malware scan: unverified → pass ▲ security
- Stability: Stability not yet verified: our sandbox run of this package did not complete, so we have no schema to compare. security
- Dependency health: partial → unverified ▼ functional
- Maintenance: unverified → pass ▲ functional
- License: unverified → pass ▲ functional
- Schema quality: Schema quality not yet verified: our sandbox run of this package did not complete, so we have no schema to assess. functional
- Capabilities: Protocol version not yet verified: our sandbox run of this package did not complete, so we never saw its MCP handshake. functional
- Tool coverage: Tool coverage not yet verified: our sandbox run of this package did not complete, so we have no tool definitions to assess. functional
- Licence: Apache-2.0 functional
- 1 Aug 26 −1
No change was recorded against any check on this day. Supply Chain Security went from 6 to 3.
- 31 Jul 26 +1
- Schema quality: Schema quality not yet verified: we do not have a sandbox capture of the MCP schema this version of the package serves yet. functional
- Tool coverage: Tool coverage not yet verified: we do not have a sandbox capture of the tool definitions this version of the package serves yet. functional
- Package version: 0.1.17 → 0.1.18 functional
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 30 Jul 26 −2
- Dependency health: partial → unverified ▼ functional
- Tool coverage: Tool coverage not yet verified: our sandbox run of this package did not complete, so we have no tool definitions to assess. functional
- Schema quality: Schema quality not yet verified: our sandbox run of this package did not complete, so we have no schema to assess. functional
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 7 Aug 2026 · Analysed npm/@cyanheads/[email protected]
Provenance No attestation
The registry publishes no build provenance for this version, so there is nothing to verify.
| Result | No attestation |
|---|---|
| Ecosystem | npm |
Dependencies 127 packages
| Packages resolved | 127 |
|---|---|
| Stale | 40 |
| Tree resolution | Complete |
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.
nvd_audit_cpe Audit CPE for Vulnerabilities ~422
Find all CVEs affecting a specific product and version using CPE (Common Platform Enumeration). Requires either an exact CPE name (cpeName) or a partial match string (virtualMatchString) with optional version range bounds. With cpeName, NVD scopes results to configurations where the product is directly vulnerable, not merely referenced as a dependency. Use nvd_search_cpes first to resolve the correct CPE string for a product. Returns full CVE records.
| Name | Type | Req | Description |
|---|---|---|---|
| allLanguages | boolean | – | When true, keeps every localized description NVD supplies on each record. Default keeps English only. |
| cpeName | string | – | Full CPEv2.3 name (e.g., "cpe:2.3:a:apache:http_server:2.4.51:*:*:*:*:*:*:*"). NVD adds isVulnerable automatically. Mutually exclusive with virtualMatchString. |
| limit | integer | – | Maximum number of CVEs to return (default 20, max 2000). |
| offset | integer | – | Zero-based page offset for pagination. Page through totalCount with a modest limit rather than raising limit — this tool returns full CVE records, so a large limit is a large response. |
| severityMin | string | – | Filter out CVEs below this severity level. Applied after NVD returns the page, so it can only drop CVEs within limit — raise limit to widen what it sees. |
| versionEnd | string | – | Upper version bound. Requires virtualMatchString. |
| versionEndType | string | – | Whether the upper version bound is inclusive or exclusive. |
| versionStart | string | – | Lower version bound. Requires virtualMatchString. |
| versionStartType | string | – | Whether the lower version bound is inclusive or exclusive. |
| virtualMatchString | string | – | Partial CPE match pattern (e.g., "cpe:2.3:a:apache:http_server:*"). Use with versionStart/versionEnd for version range audits. Mutually exclusive with cpeName. |
| Name | Type | Req | Description |
|---|---|---|---|
| auditTarget | string | yes | The CPE name or virtual match string used for this audit. |
| cves | array | yes | Full CVE records for CVEs affecting the specified product. |
| filteredCount | number | – | CVEs dropped by the severityMin filter from the page NVD returned. Present whenever severityMin is set; 0 means the filter dropped nothing, so a narrow result reflects totalCount and limit instead. T… |
| notice | string | – | Guidance on the shape of this page. When no CVEs came back it distinguishes a target NVD holds no CVEs for from a severityMin filter that dropped everything on the page, from an offset past the resul… |
| offset | number | yes | Page offset used in this query. |
| returned | number | yes | Number of CVE records returned. |
| severityMin | string | – | The client-side minimum severity filter applied. Absent when none was set. |
| totalCount | number | yes | Total CVEs matched before pagination. |
No examples provided.
nvd_get_cve Get CVE Details ~267
Fetch one or more CVEs by ID from the NIST National Vulnerability Database. Returns CVSS scores across all available versions (v2.0, v3.0, v3.1, v4.0), CWE weakness classifications, affected CPE configurations, CISA KEV fields, and references. Up to 100 CVE IDs per call. For bulk lookups of more than 10 IDs, use brief: true — full records for 100 CVEs can exceed 1MB and exhaust context budgets.
| Name | Type | Req | Description |
|---|---|---|---|
| allLanguages | boolean | – | When true, keeps every localized description NVD supplies on each record, and full records render all of them. Default keeps English only, falling back to whatever exists if a record has no English e… |
| brief | boolean | – | When true, returns trimmed records (ID, status, top CVSS score, KEV name, published date, and a truncated description) instead of full detail. Recommended for batches of more than 10 IDs. |
| cveIds | – | yes | One CVE ID or an array of up to 100 CVE IDs to fetch. |
| includeReferences | boolean | – | When false, omits the references array to reduce response size. |
| Name | Type | Req | Description |
|---|---|---|---|
| brief | boolean | yes | Whether brief or full records were returned. |
| cves | array | yes | CVE records — full detail by default, trimmed rows when brief is true. |
| missingIds | array | – | CVE IDs requested but not found in NVD. Absent when all IDs matched. |
| requested | number | yes | Number of CVE IDs requested. |
| returned | number | yes | Number of CVE records returned. |
No examples provided.
nvd_get_cve_history Get CVE Change History ~317
Retrieve the change history for a single CVE — CVSS score revisions, reference additions, status transitions (e.g., "Received" → "Analyzed"), and CPE configuration updates. Use when tracking a CVE's escalation or investigating when a score changed. Events are returned newest-first by default; pass order="oldest" for the CVE's earliest events. For the current record, call nvd_get_cve instead. The NVD history endpoint is significantly slower than other NVD endpoints, especially without an API key — set NVD_API_KEY for reliable operation.
| Name | Type | Req | Description |
|---|---|---|---|
| cveId | string | yes | CVE identifier to retrieve history for (e.g., "CVE-2021-44228"). |
| limit | integer | – | Maximum number of change events to return (default 20, max 2000). |
| offset | integer | – | Zero-based offset for paginating through change events, counted from whichever end order anchors to: offset 0 is the newest event under the default order="newest", and the oldest event under order="o… |
| order | string | – | Which end of the history to page from. Default "newest" returns the most recent events first, which is what escalation and re-score questions need. "oldest" returns NVD's native order (the CVE's firs… |
| Name | Type | Req | Description |
|---|---|---|---|
| changes | array | yes | CVE change events ordered to match the requested order — newest first by default, oldest first when order="oldest". |
| cveId | string | yes | The CVE ID for which history was retrieved. |
| notice | string | – | Guidance on the shape of this page. When no events came back it distinguishes an offset past the end of the history, from an empty page NVD returned inside a range it says has events, from a CVE NVD… |
| offset | number | yes | Page offset used in this query. |
| order | string | yes | Which end of the history this page was anchored to. |
| returned | number | yes | Number of change events returned in this response. |
| totalCount | number | yes | Total change events on record for this CVE. |
No examples provided.
nvd_search_cpes Search CPE Dictionary ~259
Search the NVD CPE (Common Platform Enumeration) dictionary by product keyword or partial match string. Returns CPE names, human-readable titles, and deprecation status. Use before nvd_audit_cpe to resolve the correct CPE name for a product — CPE strings are precise identifiers (e.g., cpe:2.3:a:apache:http_server:2.4.51:*:*:*:*:*:*:*) and must match exactly to audit the right product.
| Name | Type | Req | Description |
|---|---|---|---|
| cpeMatchString | string | – | Partial CPEv2.3 pattern (e.g., "cpe:2.3:a:apache:http_server"). At least one of keyword or cpeMatchString is required. |
| keyword | string | – | Product name or vendor keyword (e.g., "apache http server", "openssl", "nginx"). At least one of keyword or cpeMatchString is required. |
| limit | integer | – | Maximum number of CPE entries to return (default 20, max 10000). |
| offset | integer | – | Zero-based page offset for pagination. When totalCount exceeds offset + returned, raise offset to reach the rest — a vendor-level keyword has nothing left to narrow toward. |
| Name | Type | Req | Description |
|---|---|---|---|
| cpes | array | yes | Matching CPE dictionary entries. |
| notice | string | – | Guidance when no CPEs matched, the offset ran past the result set, NVD returned an empty page inside a range it says has matches, or entries remain beyond this page. |
| offset | number | yes | Page offset used in this query. |
| returned | number | yes | Number of entries returned in this response. |
| totalCount | number | yes | Total matching CPE entries before the limit was applied. |
No examples provided.
nvd_search_cves Search CVEs ~573
Search CVEs by keyword, severity, CWE, date range, or CISA KEV status. The primary discovery tool for vulnerability surveillance and triage workflows. pubDays and lastModDays are convenience shorthands that expand to date pairs; values over 120 days are clamped to the NVD maximum and reported in the response enrichment. Returns brief summaries — call nvd_get_cve for full detail on specific IDs. At least one filter is recommended; omitting all filters returns CVEs in default NVD index order (oldest first by CVE ID).
| Name | Type | Req | Description |
|---|---|---|---|
| cweId | string | – | Filter by CWE weakness ID (e.g., "CWE-79", "NVD-CWE-Other"). |
| exactPhrase | boolean | – | When true, keyword matches as an exact phrase rather than ANDing its words independently. Requires keyword. |
| kevOnly | boolean | – | When true, filters results to CVEs in the CISA Known Exploited Vulnerabilities catalog. |
| keyword | string | – | Full-text search across CVE descriptions (AND-semantics across words). |
| lastModDays | integer | – | CVEs last modified in the last N days (max 120; values over 120 are clamped). Mutually exclusive with lastModStartDate/lastModEndDate. |
| lastModEndDate | string | – | ISO 8601 datetime for last-modified range end. Both required together. |
| lastModStartDate | string | – | ISO 8601 datetime for last-modified range start. Both required together. Mutually exclusive with lastModDays. |
| limit | integer | – | Maximum number of results to return (default 20, max 2000). |
| noRejected | boolean | – | When true (default), excludes CVEs with REJECT/Rejected status. |
| offset | integer | – | Zero-based page offset for pagination. |
| pubDays | integer | – | CVEs published in the last N days (max 120; values over 120 are clamped). Mutually exclusive with pubStartDate/pubEndDate. |
| pubEndDate | string | – | ISO 8601 datetime for publication range end. Both pubStartDate and pubEndDate required together. |
| pubStartDate | string | – | ISO 8601 datetime for publication range start. Both pubStartDate and pubEndDate required together. Mutually exclusive with pubDays. |
| severity | string | – | Filter to CVEs in exactly this CVSS severity band — NVD matches the one band, not a floor. Covering several bands (e.g. HIGH and CRITICAL) takes one call per band. |
| severityVersion | string | – | CVSS version to use for the severity filter. Default: v3 (maps to cvssV3Severity). |
| Name | Type | Req | Description |
|---|---|---|---|
| cves | array | yes | Matching CVE summaries. Call nvd_get_cve for full detail on specific IDs. |
| datesClamped | array | – | Entries for any pubDays/lastModDays values that exceeded 120 and were auto-clamped. Absent when no clamping occurred. |
| filtersApplied | object | – | The non-default filters this query actually applied — the ones that can account for an empty or unexpectedly narrow result set. Absent when the query ran unfiltered, which is itself the answer when a… |
| notice | string | – | Guidance when no CVEs were returned — distinguishes a query nothing matched from an offset past the result set from an empty page NVD returned inside a range it says has matches — or, on a partial pa… |
| offset | number | yes | Page offset used in this query. |
| returned | number | yes | Number of CVEs returned in this response. |
| totalCount | number | yes | Total matching CVEs in NVD before pagination. |
No examples provided.