@cyanheads/cisa-cybersecurity-mcp-server
Public Hosted Server: https://cisa-cybersecurity.caseyjhand.com/mcp
Overview
CISA's vulnerability data in one place: the Known Exploited Vulnerabilities catalog with its remediation deadlines, per-CVE SSVC decision points, ICS advisories back to 2010, and CISA's latest alerts. Check a scan's worth of CVEs against KEV in one call, find what's overdue for a vendor, and work out BOD 26-04 timelines. No API key required.
Tools
Tool | Description |
| Decode the input vocabulary (BOD 26-04 timelines, KEV fields, SSVC values, sectors, ID formats, severity bands) and report what data the server holds |
| Check up to 200 CVE IDs against KEV in one call: deadlines, overdue status, ransomware and forensic-triage flags, cited directive |
| Search KEV by vendor, product, CWE, date added, due date, overdue status, ransomware linkage, forensic-triage tier, or directive |
| Fetch CISA's published SSVC decision points per CVE and compute the BOD 26-04 timeline for a stated asset exposure |
| Search ICS advisories by vendor, product, CVE, CWE, KEV membership, CVSS, severity, sector, series, dates, or free text |
| Read one ICS advisory: affected product versions, per-CVE CVSS and CWE, remediations, sectors, revision history |
| List CISA's latest items from its advisory, alert, or ICS advisory feed |
Resources
Resource | Description |
| One KEV catalog entry by CVE ID |
| One ICS advisory, flattened from CSAF 2.0 |
Both data resources are fully covered by the tools above. The CISA cybersecurity guide covers evidence gates, CVE-to-product investigation, and incomplete coverage. It ships with plugin, npm, Docker, and MCPB installs and is served at skill://cisa-cybersecurity-guide/SKILL.md through MCP skill discovery.
Related MCP server: Security Recipes
Capability reference
cisa_list_reference tool
One required
topic:directives,kev_fields,ssvc_values,sectors,advisory_id_formats,severity_bands, orsources; reads in-process state only, so it answers while other tools are failingdirectivesaddstimelineTable(all 16 rows of BOD 26-04 Table 1, withremediationTimelineDaysandforensicTriageRequired),definitions, andsupersedes;sourcesreports the KEVcatalogVersion, the advisory index'sready/documentCount/syncStatus, the SSVC cache TTL, and the cached feed windows
cisa_check_cve_status tool
Processes up to 200
cveIdsper call from the cached KEV snapshot with no upstream request; inputs up to 1,000 IDs return normalizedunprocessedIdsfor a follow-up call. A CVE outside KEV comes backinKev: false, not as an errorPer CVE:
dateAdded,dueDate,daysUntilDue,overdue,requiredAction,knownRansomwareCampaignUse,forensicTriage,cwes[], every URL in the entry's notes asreferences[]typed bykind, and a three-statedirective(BOD 26-04,BOD 22-01, ornull); the response echoes thecatalogsnapshot and theasOfdate the deadlines were computed againstdetail: "summary"trims each in-KEV record to the triage fields (dates, deadline status, directive, vendor and product labels, ransomware and forensic-triage flags), which keeps a full 200-CVE batch compact;fullis the default
cisa_search_kev tool
Filters AND together:
vendorProjectandproduct(CISA's own labels, not CPE names),nameContains,cwe,cveIdPrefix,dateAddedFrom/dateAddedTo,dueBefore/dueAfter,overdue,ransomware,forensicTriage,directive(BOD 26-04/BOD 22-01/none); up to 100 per page (default 25) with an opaquecursor; sorts bydateAdded(default) ordueDatevendorProjectandproductmatch case-insensitive substrings and require at least two characters after trimming surrounding whitespaceReports
totalCountandappliedFilters; each continued page uses the current call's limit. A zero-hit result names the filter responsible and what dropping it restores.nameContainssearches a-z and 0-9 after folding case and accents, and the notice names any other characters it droppeddetail: "summary"returns the eleven triage fields used bycisa_check_cve_status;fullremains the default. Each call chooses its own detail, including cursor continuations. Non-final pages point to the cursor and suggest a larger limit only below the 100-row maximumTyped errors:
catalog_unavailable(retryable),invalid_date_range,empty_search_text
cisa_get_ssvc tool
Processes up to 50
cveIdsper call through the Vulnrichment cache, fetching uncached records; inputs up to 1,000 IDs return normalizedunprocessedIdsfor a follow-up call.assetExposure:publicly_exposed,not_publicly_exposed, orunknown(default, returns both arms)Per CVE:
found,exploitation,automatable,technicalImpact,cvssandcweswhere CISA published them, andbod2604.timelines[](tableRow,remediationTimelineDays,forensicTriageRequired); a KEV entry addskevAssigned.assignmentAgreescompares the day count and forensic-triage requirement when both timelines are comparable, exposure is stated, and the KEV entry cites BOD 26-04Recognized SSVC values are normalized without regard to case. Unsupported Automatable or Technical Impact values retain the published evidence with guidance, omitting only the computed timeline and agreement.
echo.requestedcounts every submitted ID, while result totals count only processed IDsEach result carries
outcome:ssvc,not_found,no_cisa_container,no_ssvc_metric, orfetch_failed.foundCount,notFoundCount, andfailedCountseparate published SSVC, confirmed misses, and unavailable lookups;enrichment_source_unavailable(retryable) fires when every processed lookup fails
cisa_search_ics_advisories tool
Full-text
qover titles, vendor names, product names, and originating vendor advisory summaries, plusvendor,product(case-insensitive substrings, at least two characters after trimming),cve,cwe,inKev,cvssMin/cvssMax,severity,sector,series(ICSA/ICSMA),publisher(coordinator/other),publishedFrom/publishedTo,revisedFrom/revisedTo; sorts byrevised(default),published,maxCvss, orrelevance(needsq); up to 50 per page (default 20) with an opaquecursorRepublished advisories include
vendorAdvisorieswhen the source document identifies originating vendor references. A notice flags incomplete coverage of vendor advisory text while an older index re-ingestsResults carry
advisoryId, up to 20cveswithcveCount,kevCves,maxCvsswithseverityDerived,sectors,url,csafUrl, andattribution, plustotalCountandappliedFilters; a zero-hit result names the filter responsible. If the KEV snapshot isn't loaded,kevCvesis left out and says so. Non-final pages point to the cursor and suggest a larger limit only below the 50-row maximumTyped errors:
mirror_not_ready,mirror_busy, andcatalog_unavailable(retryable),mirror_unavailable,invalid_cvss_range,invalid_date_range,relevance_sort_without_query,empty_search_text
cisa_get_advisory tool
advisoryId(optional revision suffix), optionalsections(advisory,summary,products,vulnerabilities,revisionHistory,references,acknowledgments),cvesto pick vulnerability entries, andproductIdsto pick exact, case-sensitive product definitions;cvesandproductIdsimply their sectionsReturns
kind: "full", orkind: "outline"(per-section byte sizes plus the CVE IDs) when a read withoutsectionsexceeds 24,000 bytes; re-call withsections. Both arms retain advisory identity, source links, and attributionVulnerability entries retain applicability
flagsandthreats; remediations, flags, and threats resolve referenced product groups intoproductIdsand keepgroupIds. Undefined groups remain visible without invented product definitionsVulnerability entries include their own
referencesseparately from the advisory's document-level references.cvssV4Vectoris present when FIRST calculator links for that vulnerability identify one unambiguous CVSS v4 vectorAn ID not in the index returns
found: falsewithguidance,indexCheckpoint, andindexLastSyncedAt; the guidance names indexed revisions with the same base ID and notes when the advisory may be newer than the index. It never substitutes a different advisoryTyped errors:
mirror_not_readyandmirror_busy(retryable),mirror_unavailable,unknown_section,unknown_cve,cves_need_vulnerabilities_section,unknown_product_id,product_ids_need_products_section
cisa_get_alerts tool
feedselectsadvisories(default),alerts, orics. The page size defaults to 30.since(YYYY-MM-DD) filters within the available window, whose coverage dates are reported inwindow.oldestandwindow.newest.hasMoreand an opaquecursorcontinue after the last returned item within the same feed. An unavailable anchor returns an empty page with restart guidanceItems carry
title,link,pubDate, andsummarywith HTML stripped. The defaultdetail: "summary"caps descriptions at 1,200 characters and flags them withsummaryTruncated. Usedetail: "full"to read complete feed descriptions for items without anadvisoryId. Capped items with anadvisoryIdinclude guidance to callcisa_get_advisorywhen full detail is requestedEvery response carries
fetchedAtandstale; if a refresh fails, the last window is returned as stale with retry guidance, and a stale empty result doesn't prove nothing was published. With no cached window,feed_unavailable(retryable)
cisa://kev/{cveId} resource
One KEV record as
application/json, the same shape as acisa_check_cve_statusresult under the defaultdetail: "full"; a CVE not in KEV is a not-found errorListing returns the 30 most recently added entries, each named by CVE ID and vulnerability name.
cveIdcompletes from the snapshot, up to 100 suggestions
cisa://advisory/{advisoryId} resource
One flattened advisory as
application/json, with the same 24,000-byte outline-on-overflow ascisa_get_advisory; the template takes nosections,cves, orproductIds, so follow an outline up with the toolListing returns the 30 most recently revised advisories, each named by advisory ID and advisory title.
advisoryIdcompletes from the index, up to 100 suggestions
Features
Built on @cyanheads/mcp-ts-core: stdio and Streamable HTTP transports, pluggable auth (none / jwt / oauth), swappable storage (in-memory, filesystem, Supabase, Cloudflare KV/R2/D1), structured logging with optional OpenTelemetry tracing.
CISA-specific:
Four public sources, no account or key: the KEV JSON feed, Vulnrichment, the CSAF ICS advisory repository, and CISA's RSS feeds
None of them offers search, so filters run locally: KEV from an in-memory snapshot polled for changes, ICS advisories from a SQLite index with FTS5. Date filters take real calendar dates in
YYYY-MM-DDA bad KEV refresh is rejected and the last valid snapshot stays in use; with none, reads return retryable
catalog_unavailableThe KEV, SSVC, and alert tools serve from the first request while the advisory index seeds in the background
BOD 26-04 Table 1 ships as data, so a computed timeline is a table lookup over published decision points. It is not a compliance determination, and it is reported beside CISA's KEV due date, never reconciled with it
Agent-friendly output:
Provenance on every response: the KEV
catalogversion andasOfdate, the index checkpoint behind a search, andurl,csafUrl, andattributionon every advisoryDiscriminated outputs: a three-state
directive, typedreferences[].kind,found/inKevbooleans,severityDerivedon a band upstream never published, and typed error reasons with recovery hintsEmpty results and upstream gaps explain themselves: a zero-hit search names the filter responsible, and filters that hit a known gap (sector notes only from 2017, CVSS v2-only advisories, no KEV revision timestamps) say so. See Known Limitations
Getting started
Public Hosted Instance
A public instance is available at https://cisa-cybersecurity.caseyjhand.com/mcp — no installation required. Point any MCP client at it via Streamable HTTP:
{
"mcpServers": {
"cisa-cybersecurity-mcp-server": {
"type": "streamable-http",
"url": "https://cisa-cybersecurity.caseyjhand.com/mcp"
}
}
}Self-Hosted / Local
Add the following to your MCP client configuration file. No API key is required.
{
"mcpServers": {
"cisa-cybersecurity-mcp-server": {
"type": "stdio",
"command": "bunx",
"args": ["@cyanheads/cisa-cybersecurity-mcp-server@latest"],
"env": {
"MCP_TRANSPORT_TYPE": "stdio",
"MCP_LOG_LEVEL": "info"
}
}
}
}Or with npx (no Bun required):
{
"mcpServers": {
"cisa-cybersecurity-mcp-server": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@cyanheads/cisa-cybersecurity-mcp-server@latest"],
"env": {
"MCP_TRANSPORT_TYPE": "stdio",
"MCP_LOG_LEVEL": "info"
}
}
}
}Or with Docker:
{
"mcpServers": {
"cisa-cybersecurity-mcp-server": {
"type": "stdio",
"command": "docker",
"args": [
"run", "-i", "--rm",
"-e", "MCP_TRANSPORT_TYPE=stdio",
"-v", "cisa-mirror:/usr/src/app/.mirror",
"ghcr.io/cyanheads/cisa-cybersecurity-mcp-server:latest"
]
}
}
}For Streamable HTTP, set the transport and start the server:
MCP_TRANSPORT_TYPE=http MCP_HTTP_PORT=3010 bun run start:http
# Server listens at http://localhost:3010/mcpPrerequisites
Bun v1.4.4 or higher (or Node.js v24+).
No credentials. Every upstream source is keyless and public.
Installation
Clone the repository:
git clone https://github.com/cyanheads/cisa-cybersecurity-mcp-server.gitNavigate into the directory:
cd cisa-cybersecurity-mcp-serverInstall dependencies:
bun installConfiguration
Every variable is optional; the server runs correctly with none of them set.
Oversized read limits are bounded to each tool's workload cap, with notices when matching rows are omitted. CVE batches return the unprocessed IDs explicitly. All five read inputs have a hard ceiling of 1,000; malformed IDs anywhere in a batch still reject the call. Set CISA_CLAMP_OVERSIZED_INPUTS=false to reject inputs above the per-call caps with read_limit_exceeded before upstream or index work. Each normalization emits a structured log and the mcp.cisa.input.normalized counter, keyed by tool and input.
Variable | Description | Default |
| Bound oversized reads and return batch remainders; |
|
| Cron for the KEV refresh poll; |
|
| Path to the ICS advisory SQLite index. |
|
| Seed the index in the background on first run. |
|
| Cron for the advisory refresh (also runs once at startup); |
|
| TTL for a cached SSVC record. |
|
| TTL for a parsed RSS feed window. |
|
| Per-request timeout for every upstream fetch, in ms. |
|
| Transport: |
|
| HTTP server port. |
|
| HTTP session mode: |
|
| Authentication: |
|
| Log level ( |
|
| Directory for log files (Node.js only). |
|
| Storage backend for the SSVC cache: |
|
| Enable OpenTelemetry. |
|
See .env.example for the full list of optional overrides.
Running the server
Local development
Build and run:
# One-time build bun run rebuild # Run the built server bun run start:stdio # or bun run start:httpRun checks and tests:
bun run devcheck # Lint, format, typecheck, security bun run test # Vitest test suite bun run lint:mcp # Validate MCP definitions against spec
ICS advisory index
The two ICS tools and the advisory resource read a local SQLite index of the CSAF corpus at CISA_CSAF_MIRROR_PATH, defaulting to your user cache directory. On first run the server builds it in the background; until it is ready those surfaces return a retryable mirror_not_ready, and cisa_list_reference with topic sources shows progress. If the path cannot be opened, the ICS surfaces fail with a non-retryable mirror_unavailable and every other tool keeps working.
Processes sharing one index take turns syncing it. For containers, CI, or seeding out of band (CISA_CSAF_MIRROR_AUTO_INIT=false, and CISA_CSAF_REFRESH_CRON=off to leave refreshes to you), run the scripts directly:
bun run mirror:init # full build, idempotent, safe to re-run after an interrupt
bun run mirror:refresh # requires a completed mirror:init; fetches changed documents only
bun run mirror:verify # readiness, sync status, checkpoint, count, content version, SQLite integrity; non-zero on failureA transient SQLite lock returns retryable mirror_busy; retry shortly. After a partial refresh, applied rows stay readable and failed documents are retried next time; sources reports syncStatus: partial and failedDocumentCount, and mirror:refresh and mirror:verify exit non-zero.
Older indexes re-ingest in the background when auto-init is enabled. If you manage the index manually, run mirror:init to reprocess unchanged advisories when the content version advances.
Docker
docker build -t cisa-cybersecurity-mcp-server .
docker run --rm -p 3010:3010 -v cisa-mirror:/usr/src/app/.mirror cisa-cybersecurity-mcp-serverThe Dockerfile defaults to HTTP transport, stateless session mode, and logs to /var/log/cisa-cybersecurity-mcp-server. OpenTelemetry peer dependencies are installed by default — build with --build-arg OTEL_ENABLED=false to omit them. The image sets CISA_CSAF_MIRROR_PATH=/usr/src/app/.mirror/csaf.sqlite3; mount a volume over /usr/src/app/.mirror so the advisory index survives a container recreation; the image ships the mirror:* scripts for docker exec <container> bun run mirror:refresh.
Project structure
Directory | Purpose |
|
|
| Server-specific environment variable parsing and validation with Zod. |
| Tool definitions ( |
| Resource definitions ( |
| Output schemas and renderers shared by the KEV and advisory tools and resources. |
| Static reference data: BOD 26-04 Table 1, canonical sector names, CVSS bands. |
| KEV JSON feed: snapshot, derived indexes, conditional refresh. |
| Per-CVE SSVC enrichment fetch with a TTL cache. |
| The ICS advisory index: schema, ingest, normalization, queries. |
| The three RSS feeds, parsed and cached on a TTL. |
| Build, checks, and the |
| Published CISA workflow guide for agents using the server. |
| Unit, integration, fuzz, and smoke tests mirroring |
Development guide
See CLAUDE.md/AGENTS.md for development guidelines and architectural rules, and docs/design.md for the as-built specification. The short version:
Handlers throw, framework catches — no
try/catchin tool logicUse
ctx.logfor request-scoped logging,ctx.statefor tenant-scoped storageRegister new tools and resources via the barrels in
src/mcp-server/*/definitions/index.tsWrap external sources: validate raw → normalize to a domain type → return the output schema; never fabricate a field the upstream omitted
Contributing
Issues are welcome. Run checks and tests before submitting:
bun run devcheck
bun run testLicense
Apache-2.0 — see LICENSE for details.
The license covers this code, not the data it serves. KEV entries are US Government work in the public domain and Vulnrichment is CC0-1.0, but the CSAF repository declares no license and many advisories republish vendor text, so check reuse rights at each advisory's url before redistributing it. This project is not affiliated with or endorsed by CISA or the Department of Homeland Security.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
CVE, KEV, EPSS, SBOM and advisory lookups; per-CVE exposure from Shodan data (© Shodan). Keyless.
Is a CVE exploited? CISA KEV, FIRST EPSS, CVSS and SSVC with a patch-first verdict. Free, no key.
Free CVE lookups, package checks and patch priorities from public sources. No account or API key.
Read-only vulnerability intelligence: CVEs, exploitation evidence, fixes and product matches.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceProvides CVE lookup, search, and exploit intelligence from public vulnerability sources (NVD, CISA KEV, EPSS) for AI agents to produce remediation guidance without consuming LLM tokens for data fetching.1MIT
- AlicenseNot gradedqualityBmaintenanceRead-only CVE intelligence, remediation playbooks, and agent setup guides. Not a scanner.2Apache 2.0
- FlicenseNot gradedqualityBmaintenanceEnables querying official CVE List V5 records enriched with CISA KEV data, including single or batch CVE lookups and required-action guidance for known exploited vulnerabilities.-
- AlicenseAqualityAmaintenanceEnables any MCP client to look up CVE intelligence — severity summaries, filtered searches, and full per-CVE detail fusing NVD, MITRE-CNA pre-NVD, CISA KEV, EPSS, and GitHub GHSA data — alongside a Shodan-derived internet-exposure footprint showing how many internet-facing services run a version mapping to a given CVE. It is free, keyless, and read-only, and distinguishes verified zeros from unassessed or failed lookups.164,325 npm21MIT