Shodan · cyreslab-ai — Claude Code MCP server: device search and CVE lookup
Brings the Shodan API and CVE database into your AI assistant. Search for internet-connected devices, inspect vulnerabilities, and resolve DNS without leaving the editor.
no license updated 2026-10-29
Open on GitHubWhat Shodan does
The server exposes Shodan queries to your assistant. Ask for host details by IP, scan a subnet written in CIDR notation, find IoT devices of a given type, or pull the SSL certificate for a domain. DNS tools cover forward and reverse lookups plus domain records and subdomains.
The other half is vulnerability data. Search CVEs by product, CPE string, or KEV status, sort them by EPSS score, and fetch details for a single identifier. One tool, InternetDB, needs no API key and returns open ports, hostnames, CPE entries, and tags for a host.
Node.js and a Shodan API key are required. Without SHODAN_API_KEY in the environment the server will not start. Build it with npm install and npm run build, then run npm start. For Claude Desktop, add an mcpServers block with the node command and the path to build/index.js.
What it helps with
- find devices on the internet by type or filters
- look up CVE details inside the chat
- watch an IP or subnet for changes with alerts
- check a domain's SSL certificate
- resolve hostnames without a separate tool
Example prompts for the agent
- Find webcams in Germany using Shodan
- Show details for CVE-2021-44228
- Scan 192.168.1.0/24 for open devices
How to install Shodan
Install
The MCP registry has no launch command for it: see the repository README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Shodan
How do I install the Shodan MCP server in Claude Code?
Clone cyreslab-ai/shodan-mcp-server, run npm install and npm run build. Export the key with export SHODAN_API_KEY="your-api-key-here", then start the server with npm start.
What does the Shodan MCP server do?
It gives your assistant access to Shodan data: hosts, ports, services, IoT devices, SSL certificates, and DNS records. It also covers CVEs with filtering by product, CPE, KEV status, and EPSS score.
Does it require a paid Shodan API key?
Main Shodan API calls need a key, set in the SHODAN_API_KEY variable. The InternetDB tool works without a key and returns basic host data: ports, hostnames, CPEs, and vulnerabilities.
Similar MCP servers
All MCP servers for Security →Shodan by other authors comes first.