# Shodan

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: cyreslab-ai
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/cyreslab-ai/shodan-mcp-server
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/cyreslab-ai-shodan

## What it 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`.

## Requirements
- Needs: Docker

## Install

### Claude Code (native platform)

**Install**
- The MCP registry has no launch command for it: see the repository README

## When to use it
- 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
- Find webcams in Germany using Shodan
- Show details for CVE-2021-44228
- Scan 192.168.1.0/24 for open devices

## Similar
- [shodan-reconnaissance](https://affpapa.org/en/nevibecode/skills/shodan-reconnaissance.md) — skill · 86 installs
- [EchelonGraph CVE & Exposure](https://affpapa.org/en/nevibecode/mcp/echelongraph-cve-exposure.md) — MCP server · ★ 25 repo stars
- [osint-agent-skills](https://affpapa.org/en/nevibecode/mcp/osint-agent-skills.md) — MCP server · ★ 54 repo stars
- [ContrastAPI](https://affpapa.org/en/nevibecode/mcp/contrastcyber-contrastapi.md) — MCP server · 4087 installs
- [find-exposed-servers](https://affpapa.org/en/nevibecode/skills/find-exposed-servers.md) — skill · 2000 installs
- [dependencies-audit](https://affpapa.org/en/nevibecode/skills/dependencies-audit.md) — skill · 1900 installs

## Other versions with the same name
- [shodan · w0h1v](https://affpapa.org/en/nevibecode/mcp/w0h1v-shodan.md) — ★ 191 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
