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-serverIf the server publishes to npm under a different name, use that package instead — check the repo README.
MCP Server
Model Context Protocol server
Quality Score
Category
SecuritySupported Platforms
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.
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 foundOur 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.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| nist-nvd-mcp-server (this skill)by Cyreslab-AI | 81 | 10 | 2mo ago | MCP Server |
| Agent-Reachby Panniantong | 100 | 114.0k | today | CLAUDE.md |
| hyperframesby heygen-com | 100 | 88.2k | today | CLAUDE.md |
| rufloby ruvnet | 100 | 82.3k | today | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 80.5k | today | CLAUDE.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.
Skill content
View source on GitHubNIST 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 descriptionskeywordExactMatch(boolean): Exact phrase matchingcvssV3Severity(enum): LOW, MEDIUM, HIGH, CRITICALcvssV2Severity(enum): LOW, MEDIUM, HIGHcweId(string): Common Weakness Enumeration ID (e.g., "CWE-79")hasKev(boolean): CISA Known Exploited Vulnerabilities onlyhasCertAlerts(boolean): US-CERT Technical Alerts onlyhasCertNotes(boolean): CERT/CC Vulnerability Notes onlyhasOval(boolean): Only CVEs with an associated OVAL querynoRejected(boolean): Exclude rejected CVEssourceIdentifier(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 rangeresultsPerPage(number): 1-2000, default 20startIndex(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 namevirtualMatchString(string): CPE match string for broader searchesisVulnerable(boolean): Only return vulnerable configurationsversionStart/versionEnd(string): Version range filteringversionStartType/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 stringcvssV3Severity(enum): LOW, MEDIUM, HIGH, CRITICALcvssV2Metrics(string): CVSSv2 vector stringcvssV2Severity(enum): LOW, MEDIUM, HIGHcvssV4Metrics(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 rangeresultsPerPage(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 trackchangeStartDate/changeEndDate(string): Date range for changeseventName(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 filterdays(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 UUIDcpeMatchString(string): CPEv2.3-format match string (e.g., "cpe:2.3:a:apache:log4j")keywordSearch(string): Search CPE titles/references for keywordskeywordExactMatch(boolean): Exact phrase matching (requires keywordSearch)matchCriteriaId(string): Return CPEs tied to a specific Match Criteria UUIDlastModStartDate/lastModEndDate(string): Modification date range (ISO-8601, max 120 days)resultsPerPage(number): 1-10000, default 20startIndex(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 UUIDcveId(string): Return match criteria referenced by a specific CVElastModStartDate/lastModEndDate(string): Modification date range (ISO-8601, max 120 days)resultsPerPage(number): 1-5000, default 20startIndex(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
Agent-Reach
114.0kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
hyperframes
88.2kAI video you can actually edit. HyperFrames is a free, open-source AI video editor. Describe any video and get a real project you can change down to the frame.
ruflo
82.3k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
headroom
80.5kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
