Skip to main content
MCP server CX Codex

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 GitHub

What 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.

shodan w0h1v Gives your agent Shodan: open ports and banners, TLS certificates, DNS records, and vulnerability severity with EPSS and KEV in one call. CX Codex +1 ★ 191repo stars shodan-reconnaissance zebbern shodan-reconnaissance guides Claude Code through network reconnaissance using Shodan CLI and API. Helpful for discovering exposed internet hosts, open ports, and known service vulnerabilities. CX Codex +1 86installs EchelonGraph CVE & Exposure echelongraph EchelonGraph CVE & Exposure is an MCP server for Claude Code that checks vulnerabilities across NVD, KEV, and EPSS and assesses network exposure using Shodan. It helps audit SBOM files and lockfile dependencies. CX Codex +1 ★ 25repo stars osint-agent-skills frangelbarrera Turns your coding agent into an OSINT analyst with methodologies, pivot playbooks and report templates. Useful when you need cited findings instead of confident prose. CX Codex +1 ★ 54repo stars ContrastAPI contrastcyber The ContrastAPI MCP server gives an agent tools for domain checks, CVEs, threat intelligence, DNS and email security. Use it for an initial security review. CX Codex +1 4,087installs find-exposed-servers UseOSINT find-exposed-servers discovers exposed hosts, open ports and services using Shodan and Censys scan data without touching the target. Helpful for passive reconnaissance and attack surface audits. CX Codex +1 2,000installs dependencies-audit cognitedata The dependencies-audit skill finds vulnerabilities, outdated and deprecated packages, license problems and supply-chain risks, then fixes them instead of only reporting. CX Codex +1 1,900installs

Project sponsors

Companies that keep this analytics open