# io.github.cyanheads/nist-nvd-mcp-server (npm · @cyanheads/nist-nvd-mcp-server)

Search and audit NIST NVD CVEs by keyword, severity, CWE, CISA KEV status, and CPE.

- Trust score: 65/100 (medium)
- Change this week: +58
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-07

## Components

- npm · `@cyanheads/nist-nvd-mcp-server`: 65/100 (this document), [markdown](https://verifymcp.io/servers/cyanheads-nist-nvd-mcp-server/cyanheads-nist-nvd-mcp-server.md), [page](https://verifymcp.io/servers/cyanheads-nist-nvd-mcp-server/cyanheads-nist-nvd-mcp-server)

## Channel facts

- Registry: `npm`
- Package: `@cyanheads/nist-nvd-mcp-server`
- Version: `0.2.0`
- Transport: `stdio`

## Trust breakdown

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. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-07.

- **Supply Chain Security**: 98/100
  - No malware found by supply-chain analysis.
  - No known CVEs affecting this package version or its production dependencies.
  - No install/post-install scripts declared.
  - 40 of 127 dependencies flagged as unhealthy.
- **Provenance & Transparency**: 45/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (Apache-2.0).
  - Actively maintained (last published 6 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 60/100
  - AI-judged instruction clarity (excellent).
  - 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.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
  - Structured output schemas are declared (100% of tools); any adoption earns full credit.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

**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.

## Install

### Claude

```bash
claude mcp add cyanheads-nist-nvd-mcp-server -- npx -y @cyanheads/nist-nvd-mcp-server
```

### Codex

```bash
codex mcp add cyanheads-nist-nvd-mcp-server -- npx -y @cyanheads/nist-nvd-mcp-server
```

### opencode

```json
{
  "$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

```bash
openclaw mcp add cyanheads-nist-nvd-mcp-server --command npx --arg -y --arg @cyanheads/nist-nvd-mcp-server
```

### Hermes

```yaml
mcp_servers:
  cyanheads-nist-nvd-mcp-server:
    command: "npx"
    args: ["-y", "@cyanheads/nist-nvd-mcp-server"]
```

### Other

```json
{
  "mcpServers": {
    "cyanheads-nist-nvd-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/nist-nvd-mcp-server"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-07 (score 65, +3)

- [security improvement] Known CVEs: partial → pass
- [functional] Dependency health: partial → 0.85

### 2026-08-06 (score 62, +27)

- [security] Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window).
- [functional improvement] MCP protocol: unverified → pass
- [functional improvement] 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

### 2026-08-05 (score 35, +1)

- [security improvement] CVE-2026-69207 no longer affects this package
- [security improvement] Known CVEs: fail → partial

### 2026-08-04 (score 34, −1)

- [security regression] CVE-2026-69207 affects this package: medium
- [security regression] Known CVEs: partial → fail

### 2026-08-02 (score 35, +29)

- [security regression] Provenance: unverified → fail
- [security improvement] GHSA-frvp-7c67-39w9 no longer affects this package
- [security improvement] Install scripts: unverified → pass
- [security improvement] Known CVEs: unverified → partial
- [security improvement] 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.
- [functional regression] Dependency health: partial → unverified
- [functional improvement] Maintenance: unverified → pass
- [functional improvement] 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

### 2026-08-01 (score 6, −1)

No change was recorded against any check on this day. Supply Chain Security went from 6 to 3.

### 2026-07-31 (score 7, +1)

- [functional] 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

### 2026-07-30 (score 6, −2)

- [functional regression] 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.

## MCP tools (5)

### `nvd_get_cve` (~267 tokens)

Get CVE Details

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.

Input parameters:

- `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` (required): 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.

Output parameters:

- `brief` (boolean): Whether brief or full records were returned.
- `cves` (array): 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): Number of CVE IDs requested.
- `returned` (number): Number of CVE records returned.

### `nvd_search_cves` (~573 tokens)

Search CVEs

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).

Input parameters:

- `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).

Output parameters:

- `cves` (array): 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): Page offset used in this query.
- `returned` (number): Number of CVEs returned in this response.
- `totalCount` (number): Total matching CVEs in NVD before pagination.

### `nvd_audit_cpe` (~422 tokens)

Audit CPE for Vulnerabilities

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.

Input parameters:

- `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.

Output parameters:

- `auditTarget` (string): The CPE name or virtual match string used for this audit.
- `cves` (array): 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): Page offset used in this query.
- `returned` (number): Number of CVE records returned.
- `severityMin` (string): The client-side minimum severity filter applied. Absent when none was set.
- `totalCount` (number): Total CVEs matched before pagination.

### `nvd_search_cpes` (~259 tokens)

Search CPE Dictionary

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.

Input parameters:

- `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.

Output parameters:

- `cpes` (array): 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): Page offset used in this query.
- `returned` (number): Number of entries returned in this response.
- `totalCount` (number): Total matching CPE entries before the limit was applied.

### `nvd_get_cve_history` (~317 tokens)

Get CVE Change History

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.

Input parameters:

- `cveId` (string, required): 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…

Output parameters:

- `changes` (array): CVE change events ordered to match the requested order — newest first by default, oldest first when order="oldest".
- `cveId` (string): 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): Page offset used in this query.
- `order` (string): Which end of the history this page was anchored to.
- `returned` (number): Number of change events returned in this response.
- `totalCount` (number): Total change events on record for this CVE.

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/cyanheads-nist-nvd-mcp-server/cyanheads-nist-nvd-mcp-server#diagnostics

## Score history

- 2026-08-07: 65
- 2026-08-06: 62
- 2026-08-05: 35
- 2026-08-04: 34
- 2026-08-03: 35
- 2026-08-02: 35
- 2026-08-01: 6
- 2026-07-31: 7
- 2026-07-30: 6
- 2026-07-28: 8
- 2026-07-27: 26

## Links

- npm package: https://www.npmjs.com/package/@cyanheads/nist-nvd-mcp-server
- Socket report: https://socket.dev/npm/package/@cyanheads/nist-nvd-mcp-server
- Repository: https://github.com/cyanheads/nist-nvd-mcp-server
- Changelog RSS feed: https://verifymcp.io/servers/cyanheads-nist-nvd-mcp-server/cyanheads-nist-nvd-mcp-server.xml
- Changelog JSON feed: https://verifymcp.io/servers/cyanheads-nist-nvd-mcp-server/cyanheads-nist-nvd-mcp-server.json
- HTML version of this page: https://verifymcp.io/servers/cyanheads-nist-nvd-mcp-server/cyanheads-nist-nvd-mcp-server