SkillAgentSearch skills...

nist-nvd-mcp-server

MCP server for the NIST National Vulnerability Database (NVD) — search CVE and CPE data with API-key support.

Install / Use

claude mcp add Cyreslab-AI -- npx -y github:Cyreslab-AI/nist-nvd-mcp-server

If the server publishes to npm under a different name, use that package instead — check the repo README.

About this skill
🔌

MCP Server

Model Context Protocol server

Quality Score

81/100

Category

Security

Supported Platforms

Claude Code
Claude Desktop

Our assessment of nist-nvd-mcp-server

nist-nvd-mcp-server scores 81/100 on our quality scale, 970th of 1,098 Security skills we index.

Its MCP Server is 14 KB long, well organised into 43 sections with 22 code examples: a thorough specification that gives an agent plenty to work with.

It has 10 GitHub stars, so there is little community track record yet; judge it on its content.

Substance
30/30
Structure
20/20
Description
12/15
Adoption
4/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated about 2 months ago, so nist-nvd-mcp-server is actively maintained.
  • It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 97/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands.

Automated pattern scan on 2026-11-22. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

nist-nvd-mcp-server compared with similar skills

All 4 of these similar skills score higher than nist-nvd-mcp-server; compare them before choosing.

SkillScoreStarsUpdatedFormat
nist-nvd-mcp-server (this skill)by Cyreslab-AI81102mo agoMCP Server
Agent-Reachby Panniantong100114.0ktodayCLAUDE.md
hyperframesby heygen-com10088.2ktodayCLAUDE.md
rufloby ruvnet10082.3ktodayCLAUDE.md
headroomby headroomlabs-ai10080.5ktodayCLAUDE.md

Frequently asked questions

How do I install nist-nvd-mcp-server?
Run claude mcp add Cyreslab-AI -- npx -y github:Cyreslab-AI/nist-nvd-mcp-server. The install tabs above show the steps for each supported agent.
Which AI agents does nist-nvd-mcp-server work with?
It is written for Claude Code and Claude Desktop, as a MCP Server file. Other agents that read the same format can often use it too.
Is nist-nvd-mcp-server safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. It is MIT-licensed and scores 97/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is nist-nvd-mcp-server still maintained?
The repository was last updated about 2 months ago, so nist-nvd-mcp-server is actively maintained.

NIST NVD MCP Server

A comprehensive Model Context Protocol (MCP) server providing access to the NIST National Vulnerability Database (NVD) API. This server enables AI agents to search, retrieve, and analyze vulnerability data from the authoritative U.S. government repository of standards-based vulnerability management data.

Features

Core Capabilities

  • CVE Search & Retrieval: Advanced search with keyword, date, severity, and CWE filtering
  • CPE-Based Searches: Find vulnerabilities affecting specific products and versions
  • CPE Dictionary & Match Criteria: Browse the official CPE Dictionary and inspect the version-range match rules NVD uses to link CVEs to CPEs
  • CVSS Analysis: Filter by CVSS v2/v3/v4 scores and severity ratings
  • Change History Tracking: Monitor CVE modifications and analysis updates
  • High-Priority Detection: Automated discovery of CISA KEV, CERT alerts, and critical CVEs
  • Comprehensive Filtering: Date ranges, rejection status, source identifiers, CVE tags, and more

Advanced Features

  • Intelligent Caching: 5-minute TTL with automatic cleanup
  • Rate Limiting: Built-in retry logic with exponential backoff
  • Error Handling: Comprehensive HTTP error handling and user-friendly messages
  • Data Validation: NIST API compliance with proper date range enforcement (120-day max)
  • Rich Formatting: Enhanced JSON responses with security metrics extraction

Installation

npm install @cyreslab/nist-nvd-mcp-server

Or clone and build locally:

git clone https://github.com/cyreslab/nist-nvd-mcp-server.git
cd nist-nvd-mcp-server
npm install
npm run build

API Key (Optional, Strongly Recommended)

The NVD API works without a key, but with a much lower rate limit:

| | Without a key | With a free key | |---|---|---| | Rate limit | 5 requests / 30 seconds | 50 requests / 30 seconds |

Some tools in this server (e.g. search_high_priority_cves) fire several requests concurrently per call, so an unauthenticated setup can hit the rate limit quickly.

Get a free key: Request one at https://nvd.nist.gov/developers/request-an-api-key (a valid email address is all that's required; the key arrives by email).

Set it as an environment variable before starting the server:

export NVD_API_KEY="your-key-here"
npm start

Or in your MCP client configuration:

{
  "servers": {
    "nist-nvd": {
      "command": "node",
      "args": ["/path/to/nist-nvd-mcp-server/build/index.js"],
      "env": {
        "NVD_API_KEY": "your-key-here"
      }
    }
  }
}

If NVD_API_KEY is not set, the server logs a one-time reminder to stderr and runs unauthenticated.

Quick Start

Basic Usage

# Run the server
npm start

# Or run in development mode
npm run dev

Integration with AI Agents

Add to your MCP client configuration:

{
  "servers": {
    "nist-nvd": {
      "command": "node",
      "args": ["/path/to/nist-nvd-mcp-server/build/index.js"]
    }
  }
}

Available Tools

1. search_cves

Search CVEs with comprehensive filtering options.

Parameters:

  • keywordSearch (string): Search terms in CVE descriptions
  • keywordExactMatch (boolean): Exact phrase matching
  • cvssV3Severity (enum): LOW, MEDIUM, HIGH, CRITICAL
  • cvssV2Severity (enum): LOW, MEDIUM, HIGH
  • cweId (string): Common Weakness Enumeration ID (e.g., "CWE-79")
  • hasKev (boolean): CISA Known Exploited Vulnerabilities only
  • hasCertAlerts (boolean): US-CERT Technical Alerts only
  • hasCertNotes (boolean): CERT/CC Vulnerability Notes only
  • hasOval (boolean): Only CVEs with an associated OVAL query
  • noRejected (boolean): Exclude rejected CVEs
  • sourceIdentifier (string): Filter by the reporting/managing organization (e.g., "cve@mitre.org")
  • cveTag (enum): "disputed", "unsupported-when-assigned", or "exclusively-hosted-service"
  • pubStartDate/pubEndDate (string): Publication date range (ISO-8601)
  • lastModStartDate/lastModEndDate (string): Modification date range
  • resultsPerPage (number): 1-2000, default 20
  • startIndex (number): Pagination offset

Example:

{
  "keywordSearch": "remote code execution",
  "cvssV3Severity": "CRITICAL",
  "hasKev": true,
  "resultsPerPage": 10
}

2. get_cve

Retrieve detailed information about a specific CVE.

Parameters:

  • cveId (string, required): CVE identifier (e.g., "CVE-2021-44228")

Example:

{
  "cveId": "CVE-2021-44228"
}

3. search_cves_by_cpe

Find CVEs affecting specific products using CPE.

Parameters:

  • cpeName (string): Full CPE name
  • virtualMatchString (string): CPE match string for broader searches
  • isVulnerable (boolean): Only return vulnerable configurations
  • versionStart/versionEnd (string): Version range filtering
  • versionStartType/versionEndType (enum): "including" or "excluding"

Example:

{
  "virtualMatchString": "cpe:2.3:a:apache:log4j",
  "versionStart": "2.0",
  "versionStartType": "including",
  "versionEnd": "2.15.0",
  "versionEndType": "excluding"
}

4. search_cves_by_cvss

Search CVEs by CVSS vector strings and severity.

Parameters:

  • cvssV3Metrics (string): CVSSv3 vector string
  • cvssV3Severity (enum): LOW, MEDIUM, HIGH, CRITICAL
  • cvssV2Metrics (string): CVSSv2 vector string
  • cvssV2Severity (enum): LOW, MEDIUM, HIGH
  • cvssV4Metrics (string): CVSSv4 vector string (experimental)

Example:

{
  "cvssV3Severity": "CRITICAL"
}

5. search_recent_cves

Get recently published CVEs.

Parameters:

  • days (number): Days back from today (1-120)
  • pubStartDate/pubEndDate (string): Custom date range
  • resultsPerPage (number): Default 50

Example:

{
  "days": 7,
  "resultsPerPage": 25
}

6. search_modified_cves

Get recently modified CVEs.

Parameters:

  • days (number): Days back from today (1-120)
  • lastModStartDate/lastModEndDate (string): Custom date range

Example:

{
  "days": 3
}

7. get_cve_change_history

Track CVE modification history.

Parameters:

  • cveId (string): Specific CVE to track
  • changeStartDate/changeEndDate (string): Date range for changes
  • eventName (enum): Filter by event type:
    • "CVE Received", "Initial Analysis", "Reanalysis"
    • "CVE Modified", "Modified Analysis", "CVE Translated"
    • "Vendor Comment", "CVE Source Update"
    • "CPE Deprecation Remap", "CWE Remap"
    • "Reference Tag Update", "CVE Rejected"
    • "CVE Unrejected", "CVE CISA KEV Update"

Example:

{
  "cveId": "CVE-2021-44228",
  "eventName": "Initial Analysis"
}

8. search_high_priority_cves

Find high-priority CVEs using multiple risk indicators.

Parameters:

  • includeKev (boolean): Include CISA KEV (default: true)
  • includeCertAlerts (boolean): Include CERT alerts (default: true)
  • includeCriticalCvss (boolean): Include critical CVSS (default: true)
  • minCvssScore (number): Minimum CVSS threshold (0-10, default: 7.0)
  • keywordSearch (string): Additional keyword filter
  • days (number): Limit to recent CVEs (max 120)

Example:

{
  "minCvssScore": 9.0,
  "days": 30,
  "keywordSearch": "authentication bypass"
}

9. search_cpe_dictionary

Browse or search the official CPE (Common Platform Enumeration) Dictionary to find canonical product/version identifiers.

Parameters:

  • cpeNameId (string): Return a specific CPE record by its UUID
  • cpeMatchString (string): CPEv2.3-format match string (e.g., "cpe:2.3:a:apache:log4j")
  • keywordSearch (string): Search CPE titles/references for keywords
  • keywordExactMatch (boolean): Exact phrase matching (requires keywordSearch)
  • matchCriteriaId (string): Return CPEs tied to a specific Match Criteria UUID
  • lastModStartDate/lastModEndDate (string): Modification date range (ISO-8601, max 120 days)
  • resultsPerPage (number): 1-10000, default 20
  • startIndex (number): Pagination offset

Example:

{
  "keywordSearch": "log4j",
  "resultsPerPage": 10
}

10. search_cpe_match_criteria

Search the CPE Match Criteria API to see the version-range matching rules NVD uses to link CVEs to CPEs.

Parameters:

  • matchCriteriaId (string): Return a specific Match Criteria record by its UUID
  • cveId (string): Return match criteria referenced by a specific CVE
  • lastModStartDate/lastModEndDate (string): Modification date range (ISO-8601, max 120 days)
  • resultsPerPage (number): 1-5000, default 20
  • startIndex (number): Pagination offset

Example:

{
  "cveId": "CVE-2021-44228"
}

Response Format

All tools return structured JSON responses with:

CVE Responses

{
  "summary": {
    "search_context": "search description",
    "total_results": 1500,
    "showing_results": 20,
    "results_per_page": 20,
    "start_index": 0,
    "timestamp": "2025-06-08T14:26:00.000Z"
  },
  "vulnerabilities": [
    {
      "cve_id": "CVE-2021-44228",
      "status": "Analyzed",
      "published": "2021-12-10T10:15:09.043",
      "last_modified": "2021-12-29T00:15:09.427",
      "description": "Apache Log4j2 <=2.14.1 JNDI features...",
      "cvss": {
        "v3_score": 10.0,
        "v3_severity": "CRITICAL",
        "v2_score": 9.3
      },
      "weaknesses": ["CWE-502", "CWE-400"],
      "reference_count": 15,
      "cisa_kev": {
        "exploitAdd": "2021-12-10",
        "actionDue": "2021-12-24",
        "requiredAction": "Apply updates per vendor instructions.",
        "vulnerabilityName": "Apache Log4j2 Remote Code Execution Vulnerability"
      },
      "configurations_count": 200
    }
  ],
  "raw_response_metadata": {
    "format": "NVD_CVE",
    "version": "2.0",
    "has_more_results": true
  }
}

Change History Responses

{
  "summary": {
    "search_context": "change history for CVE-2021-44228",
    "total_changes": 5,
    "showing_changes": 5
  },
  "changes": [
    {
      "cve_id": "CVE-2021-44228",
      "event_name": "Initial Analysis",
      "change_id": "ABC123-DEF456",
      "source": "nvd@nist.gov",
      "created": "2021-12-10T15:30:00.000Z",
      "details_count": 8,
      "sample_details": [
        {
          "action": "Added",
          "type": "CVSS V3.1",
          "newValue": "NIST AV:N/AC:L/PR:N/UI:N/S:C/C:H/I:H/A:H"
        }
      ]
    }
  ]
}

Use Cases for AI Agents

1. Threat Intelligence Analysis

{
  "tool": "search_high_priority_cves",
  "args": {
    "days": 7,
    "minCvssScore": 8.0,
    "includeKev": true
  }
}

2. Software Asset Vulnerability Assessment

{
  "tool": "search_cves_by_cpe",
  "args": {
    "virtualMatchString": "cpe:2.3:a:microsoft:windows",
    "versionStart": "10",
    "versionStartType": "including"
  }
}

3. Security Research & Analysis

{
  "tool": "search_cves",
  "args": {
    "keywordSearch": "authentication bypass",
    "cvssV3Severity": "HIGH",
    "noRejected": true
  }
}

4. Vulnerability Lifecycle Monitoring

{
  "tool": "get_cve_change_history",
  "args": {
    "changeStartDate": "2024-01-01T00:00:00.000Z",
    "changeEndDate": "2024-01-31T23:59:59.999Z",
    "eventName": "CISA KEV Update"
  }
}

API Limits & Best Practices

NIST NVD API Constraints

  • Date Range Limit: Maximum 120 consecutive days
  • Rate Limiting: Built-in retry logic handles API limits; 5 req/30s without a key, 50 req/30s with a free NVD_API_KEY (see API Key above)
  • No API Key Required: Free access to public data (a key is optional but recommended)
  • Data Freshness: Real-time access to official NIST data

Optimization Tips

  • Use caching effectively (5-minute TTL implemented)
  • Implement reasonable page sizes (20-100 results)
  • Leverage specific filters to reduce result sets
  • Monitor for rate limiting in high-volume scenarios

Error Handling

The server

Truncated for display — read the full file on GitHub.

Related Skills

View on GitHub
GitHub Stars10
CategorySecurity
Updated2mo ago
Forks2

Languages

TypeScript

Trust signals

97/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

1 info