# Vulners MCP

> Vulners MCP is a freemium MCP server for security. MCP server giving AI assistants access to the Vulners vulnerability database. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, API, Web, Linux, macOS, Windows, self-hosted
- **Repository:** https://github.com/vulnerscom/vulners-mcp
- **MCP Registry name:** io.github.vulnersCom/vulners-mcp
- **Categories:** [security](https://ai-powered.com/categories/security)
- **Listing updated:** 2026-11-18

## About

The Vulners MCP server connects MCP-compatible AI clients such as Claude Desktop to the Vulners vulnerability knowledge base. Instead of writing API queries by hand, a security researcher can ask an assistant to look up a CVE, search bulletins with Lucene syntax, or audit a software version or Linux package list for known issues.

The README describes two ways to run it: a local stdio process started through PyPI, a Docker image, or a source build, with the user's own Vulners API key set as an environment variable; or an HTTP endpoint at mcp.vulners.com, where each request carries an X-Api-Key header. The hosted endpoint also offers a reduced-limit anonymous tier when no key is sent, according to the README.

The server exposes seven tools covering bulletin lookup by ID, Lucene discovery search, version-specific software audits, Linux package audits, CPE search, autocomplete and supported OS listing. It is aimed at security teams, researchers and developers who want vulnerability triage inside an AI assistant workflow.

## Features

- **Known-ID bulletin lookup:** Fetches a CVE or Vulners bulletin by identifier, returning a compact summary by default with optional extra fields.
- **Lucene vulnerability search:** Runs full-text Lucene queries across the Vulners knowledge base for discovery when specific IDs are unknown.
- **Software version audit:** Checks a specific software version, given as a CPE string or vendor, product and version, for known vulnerabilities.
- **Linux package audit:** Analyzes RPM or DEB package lists for a chosen distribution and release against the database.
- **CPE search and autocomplete:** Finds CPE identifiers by vendor and product and suggests search terms for vendors, products and CVEs.
- **Stdio and HTTP transports:** Runs locally over stdio for desktop clients or as a stateless Streamable HTTP server.

## Good for

- Triage a CVE list by asking an assistant for bulletin details and exploitation signals
- Audit a specific browser or application version for known vulnerabilities
- Check an Ubuntu or other Linux package set against the vulnerability database
- Search recent vulnerabilities affecting a named vendor or product
- Feed CVE identifiers from an audit into batch bulletin lookups

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http vulners-mcp https://mcp.vulners.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.vulners.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "vulners-mcp": {
      "url": "https://mcp.vulners.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "vulners-mcp": {
      "type": "http",
      "url": "https://mcp.vulners.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "vulners-mcp": {
      "serverUrl": "https://mcp.vulners.com/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "vulners-mcp": {
      "type": "http",
      "url": "https://mcp.vulners.com/mcp"
    }
  }
}
```

## Tools

- `search_lucene`: Full-text search of the Vulners knowledge base using Lucene syntax, for discovery.
- `bulletin_by_id`: Fetch a bulletin by CVE or Vulners ID, with optional fields and references.
- `query_autocomplete`: Autocomplete suggestions for vendors, products, CVEs and similar inputs.
- `search_cpe`: Find CPE strings by vendor and product.
- `audit_software`: Audit a specific software version for known vulnerabilities.
- `audit_linux_packages`: Audit RPM or DEB packages for a given Linux distribution and version.
- `get_supported_os`: List supported OS identifiers and versions for Linux package audits.

## FAQ

### Do I need an API key?

The README says a Vulners API key is needed for full access. Keys are generated from the Vulners account under the API KEYS tab with the api scope. The hosted HTTP endpoint allows keyless calls only on an anonymous tier, if the deployment has one configured.

### Which AI clients does it work with?

The README names Claude Desktop and says it works with other MCP-compatible clients. It also shows setup snippets for Claude Code and Cursor against the hosted endpoint.

### How can it be run?

It can be installed from PyPI and run with uvx or pip, pulled as a Docker image from GHCR, or built from source. A hosted Streamable HTTP endpoint is also provided at mcp.vulners.com.

### What license is it under?

The README states the project is released under the MIT license.

### Is Vulners MCP free?

Vulners MCP has a free plan, with paid plans for more usage or features.

### How do I add Vulners MCP to Claude Code?

Run this command in your terminal: claude mcp add --transport http vulners-mcp https://mcp.vulners.com/mcp

### What are the best alternatives to Vulners MCP?

The closest alternatives to Vulners MCP are vulnerable.now, MCPVetter, CVE Security Advisories (NVD High & Critical) — buy per-query in-session (cvewatch), Vdb and TrustedMCP.

## Where this comes from

- Description: written from the project's README and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [vulnerable.now](https://ai-powered.com/mcp/vulnerable-now): vulnerable.now is a free MCP server for security.
- [MCPVetter](https://ai-powered.com/mcp/mcpvetter): MCPVetter is a freemium MCP server for security.
- [CVE Security Advisories (NVD High & Critical) — buy per-query in-session (cvewatch)](https://ai-powered.com/mcp/cve-security-advisories-nvd-high-and-critical-buy-per-query): CVE Security Advisories (NVD High & Critical) — buy per-query in-session (cvewatch) is an MCP server for security.
- [Vdb](https://ai-powered.com/mcp/vdb): Vdb is a free MCP server for security.
- [TrustedMCP](https://ai-powered.com/mcp/trustedmcp): TrustedMCP is a free MCP server for security.
- [Dependency Vulnerability Tracker — package security advisories ($0.01/query)](https://ai-powered.com/mcp/dependency-vulnerability-tracker-package-security-advisories): Dependency Vulnerability Tracker — package security advisories ($0.01/query) is a paid MCP server for security.
- [CISA Known Exploited Vulnerabilities (kevwatch)](https://ai-powered.com/mcp/cisa-known-exploited-vulnerabilities-kevwatch): CISA Known Exploited Vulnerabilities (kevwatch) is an MCP server for security.
- [UND Assay](https://ai-powered.com/mcp/und-assay): UND Assay is a free MCP server for security.

---
Source: https://ai-powered.com/mcp/vulners-mcp
