# Shodan MCP Server

Access Shodan's API to enhance your AI assistant's capabilities. Query detailed information about internet-connected devices and services to bolster cybersecurity research and threat intelligence. Si…

## Quick Start

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

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

# Get full schema for a tool
npx -y @smithery/cli@latest tool get Cyreslab-AI/shodan-mcp-server get_host_info

# Call a tool
npx -y @smithery/cli@latest tool call Cyreslab-AI/shodan-mcp-server get_host_info '{}'
```

## Tools (23)

- `get_host_info` — Get detailed information about a specific IP address
- `search_shodan` — Search Shodan's database for devices and services
- `scan_network_range` — Scan a network range (CIDR notation) for devices
- `get_ssl_info` — Get SSL certificate information for a domain
- `search_iot_devices` — Search for specific types of IoT devices
- `get_host_count` — Get the count of hosts matching a search query without consuming query credits
- `list_search_facets` — List all available search facets that can be used with Shodan queries
- `list_search_filters` — List all available search filters that can be used in Shodan queries
- `parse_search_tokens` — Parse a search query to understand which filters and parameters are being used
- `list_ports` — List all ports that Shodan crawls on the Internet
- `list_protocols` — List all protocols that can be used when performing on-demand Internet scans
- `get_api_info` — Get information about your API plan including credits and limits
- `get_my_ip` — Get your current IP address as seen from the Internet
- `dns_lookup` — Resolve hostnames to IP addresses using DNS lookup
- `reverse_dns_lookup` — Get hostnames for IP addresses using reverse DNS lookup
- `get_domain_info` — Get comprehensive domain information including subdomains and DNS records
- `get_account_profile` — Get account profile information including membership status and credits
- `get_cve_info` — Get detailed information about a specific CVE
- `search_cves` — Search for vulnerabilities with various filters
- `get_cpes` — Get Common Platform Enumeration (CPE) information for products
- `get_newest_cves` — Get the newest vulnerabilities from the CVE database
- `get_kev_cves` — Get Known Exploited Vulnerabilities (KEV) from CISA
- `get_cves_by_epss` — Get CVEs sorted by EPSS score (Exploit Prediction Scoring System)

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

## Resources

- `shodan://host/example` — Information about a specific IP address from Shodan

---

Source: https://github.com/Cyreslab-AI/shodan-mcp-server