# Shodan Server

A Model Context Protocol server for querying the Shodan API and Shodan CVEDB, providing access to network intelligence and security services.

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add burtthecoder/mcp-shodan

# Browse available tools
npx -y @smithery/cli@latest tool list burtthecoder/mcp-shodan

# Get full schema for a tool
npx -y @smithery/cli@latest tool get burtthecoder/mcp-shodan ip_lookup

# Call a tool
npx -y @smithery/cli@latest tool call burtthecoder/mcp-shodan ip_lookup '{}'
```

## Tools (7)

- `ip_lookup` — Retrieve comprehensive information about an IP address, including geolocation, open ports, running services, SSL certif…
- `shodan_search` — Search Shodan's database of internet-connected devices. Returns detailed information about matching devices including s…
- `cve_lookup` — Query detailed vulnerability information from Shodan's CVEDB. Returns comprehensive CVE details including CVSS scores (…
- `dns_lookup` — Resolve domain names to IP addresses using Shodan's DNS service. Supports batch resolution of multiple hostnames in a s…
- `cpe_lookup` — Search for Common Platform Enumeration (CPE) entries by product name in Shodan's CVEDB. Supports pagination and can ret…
- `cves_by_product` — Search for vulnerabilities affecting specific products or CPEs. Supports filtering by KEV status, sorting by EPSS score…
- `reverse_dns_lookup` — Perform reverse DNS lookups to find hostnames associated with IP addresses. Supports batch lookups of multiple IP addre…

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get burtthecoder/mcp-shodan <tool-name>
```

---

Source: https://github.com/BurtTheCoder/mcp-shodan | License: MIT
