Shodan MCP Server
This server lets AI assistants query Shodan for internet-connected device intelligence, vulnerability/CVE data, network monitoring, and account/utility functions.
Host & Device Intelligence: Get host details by IP, search Shodan for devices/services, count hosts, scan CIDR network ranges, and search for IoT devices.
SSL & DNS: Retrieve SSL certificate info for domains, perform DNS and reverse DNS lookups, and get comprehensive domain info (subdomains, records).
Vulnerability & CVE Research: Look up CVE details, search CVEs by product/CPE/KEV/EPSS, list newest CVEs and known exploited vulnerabilities, and get CPE data.
Exploit & InternetDB Lookups: Search Shodan's Exploits database and query InternetDB for free host info (open ports, hostnames, CPEs, vulns, tags) without an API key.
Network Alerts & Notifiers: Create/list/inspect/delete network alerts, list notifier providers, and manage notifiers for alert notifications.
Search Utilities: List available facets/filters, parse search queries, list crawled ports, and list scan protocols.
Account & Utility: Check API plan/info, account profile, and your current public IP.
Supports configuration via .env file to securely store the Shodan API key
Provides repository hosting for the Shodan MCP Server code and issue tracking
Example in search patterns for finding SSL certificates issued to Google
The MCP server runs on Node.js (v16 or higher), providing the runtime environment for accessing Shodan API functionality
Used for managing dependencies and building the project, required for installation (v7 or higher)
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Shodan MCP Server search for exposed webcams in the US"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.

Shodan MCP Server
A Model Context Protocol (MCP) server that provides access to Shodan API functionality and CVE database, allowing AI assistants to query information about internet-connected devices, services, and vulnerabilities.
Features
Network Intelligence
Host Information: Get detailed information about specific IP addresses
Search Capabilities: Search Shodan's database for devices and services
Network Scanning: Scan network ranges (CIDR notation) for devices
SSL Certificate Information: Get SSL certificate details for domains
IoT Device Search: Find specific types of IoT devices
Vulnerability Intelligence
CVE Lookup: Get detailed information about specific vulnerabilities
Vulnerability Search: Search CVEs with advanced filters (product, KEV status, EPSS scores)
CPE Information: Get Common Platform Enumeration data for products
Latest Vulnerabilities: Access newest CVEs and Known Exploited Vulnerabilities
Exploit Prediction: Get CVEs sorted by EPSS exploit prediction scores
Exploit Search: Search Shodan's Exploits database for CVE-linked exploits
InternetDB Lookup: Free, no-API-key host lookup (open ports, hostnames, CPEs, vulns, tags)
Network Monitoring
Network Alerts: Create, list, inspect, and delete persistent alerts that monitor IPs/ranges for changes
Notifiers: List available notifier providers and manage notifiers (Slack, email, webhook, etc.) that alerts can send events to
Related MCP server: sec-shodan-mcp
Installation
Clone the repository:
git clone https://github.com/Cyreslab-AI/shodan-mcp-server.git cd shodan-mcp-serverInstall dependencies:
npm installBuild the server:
npm run buildSet up your Shodan API key:
export SHODAN_API_KEY="your-api-key-here"Start the server:
npm start
MCP Integration
This server can be integrated with Claude or other MCP-compatible AI assistants. To add it to Claude Desktop or Claude.app:
Add the server to your MCP settings:
{ "mcpServers": { "shodan": { "command": "node", "args": ["/path/to/shodan-mcp-server/build/index.js"], "env": { "SHODAN_API_KEY": "your-api-key-here" } } } }Restart Claude to load the new MCP server.
Available Tools
Search & Host Information Tools
get_host_info
Get detailed information about a specific IP address.
Parameters:
ip(required): IP address to look upmax_items(optional): Maximum number of items to include in arrays (default: 5)fields(optional): List of fields to include in the results (e.g., ['ip_str', 'ports', 'location.country_name'])
search_shodan
Search Shodan's database for devices and services.
Parameters:
query(required): Shodan search query (e.g., 'apache country:US')page(optional): Page number for results pagination (default: 1)facets(optional): List of facets to include in the search results (e.g., ['country', 'org'])max_items(optional): Maximum number of items to include in arrays (default: 5)fields(optional): List of fields to include in the results (e.g., ['ip_str', 'ports', 'location.country_name'])summarize(optional): Whether to return a summary of the results instead of the full data (default: false)
get_host_count
Get the count of hosts matching a search query without consuming query credits.
Parameters:
query(required): Shodan search query to count hosts forfacets(optional): List of facets to include in the count results (e.g., ['country', 'org'])
scan_network_range
Scan a network range (CIDR notation) for devices.
Parameters:
cidr(required): Network range in CIDR notation (e.g., 192.168.1.0/24)max_items(optional): Maximum number of items to include in results (default: 5)fields(optional): List of fields to include in the results (e.g., ['ip_str', 'ports', 'location.country_name'])
search_iot_devices
Search for specific types of IoT devices.
Parameters:
device_type(required): Type of IoT device to search for (e.g., 'webcam', 'router', 'smart tv')country(optional): Optional country code to limit search (e.g., 'US', 'DE')max_items(optional): Maximum number of items to include in results (default: 5)
SSL & Certificate Tools
get_ssl_info
Get SSL certificate information for a domain.
Parameters:
domain(required): Domain name to look up SSL certificates for (e.g., example.com)
DNS Tools
dns_lookup
Resolve hostnames to IP addresses using DNS lookup.
Parameters:
hostnames(required): List of hostnames to resolve (e.g., ['google.com', 'facebook.com'])
reverse_dns_lookup
Get hostnames for IP addresses using reverse DNS lookup.
Parameters:
ips(required): List of IP addresses to lookup (e.g., ['8.8.8.8', '1.1.1.1'])
get_domain_info
Get comprehensive domain information including subdomains and DNS records.
Parameters:
domain(required): Domain name to lookup (e.g., 'google.com')history(optional): Include historical DNS data (default: false)type(optional): DNS record type filter (A, AAAA, CNAME, NS, SOA, MX, TXT)page(optional): Page number for pagination (default: 1)
Search Utility Tools
list_search_facets
List all available search facets that can be used with Shodan queries.
Parameters: None
list_search_filters
List all available search filters that can be used in Shodan queries.
Parameters: None
parse_search_tokens
Parse a search query to understand which filters and parameters are being used.
Parameters:
query(required): Shodan search query to parse and analyze
Infrastructure Tools
list_ports
List all ports that Shodan crawls on the Internet.
Parameters: None
list_protocols
List all protocols that can be used when performing on-demand Internet scans.
Parameters: None
CVE & Vulnerability Tools
get_cve_info
Get detailed information about a specific CVE.
Parameters:
cve_id(required): CVE ID to look up (e.g., 'CVE-2021-44228')
search_cves
Search for vulnerabilities with various filters.
Parameters:
cpe23(optional): CPE 2.3 string to search for (e.g., 'cpe:2.3:a:apache:log4j:*')product(optional): Product name to search for vulnerabilities (e.g., 'apache', 'windows')is_kev(optional): Filter for Known Exploited Vulnerabilities onlysort_by_epss(optional): Sort results by EPSS score (Exploit Prediction Scoring System)start_date(optional): Start date for filtering CVEs (YYYY-MM-DD format)end_date(optional): End date for filtering CVEs (YYYY-MM-DD format)limit(optional): Maximum number of results to return (default: 10)skip(optional): Number of results to skip for pagination (default: 0)
get_cpes
Get Common Platform Enumeration (CPE) information for products.
Parameters:
product(optional): Product name to search for (e.g., 'apache', 'windows')vendor(optional): Vendor name to filter by (e.g., 'microsoft', 'apache')version(optional): Version to filter by (e.g., '2.4.1')limit(optional): Maximum number of results to return (default: 10)skip(optional): Number of results to skip for pagination (default: 0)
get_newest_cves
Get the newest vulnerabilities from the CVE database.
Parameters:
limit(optional): Maximum number of results to return (default: 10)
get_kev_cves
Get Known Exploited Vulnerabilities (KEV) from CISA.
Parameters:
limit(optional): Maximum number of results to return (default: 10)
get_cves_by_epss
Get CVEs sorted by EPSS score (Exploit Prediction Scoring System).
Parameters:
limit(optional): Maximum number of results to return (default: 10)
get_internetdb_host
Get a free, lightweight lookup of an IP address using Shodan's InternetDB (open ports, hostnames, CPEs, vulnerabilities, tags). No API key required.
Parameters:
ip(required): IP address to look up (e.g., '8.8.8.8')
search_exploits
Search Shodan's Exploits database (Exploit-DB, Metasploit, CVE-linked exploits) for known exploits.
Parameters:
query(required): Exploits search query (e.g., 'apache cve:2021-44228')page(optional): Page number for results pagination (default: 1)facets(optional): List of facets to include in the results (e.g., ['type', 'platform'])
Note: As of this writing, the upstream exploits.shodan.io host redirects to cvedb.shodan.io and no longer serves this API. The tool detects this and returns a clean {"error": "Unexpected response from the Shodan Exploits API", ...} object rather than crashing, in case Shodan restores the endpoint.
count_exploits
Get the count of exploits matching a search query without returning the full exploit records.
Parameters:
query(required): Exploits search query to count results forfacets(optional): List of facets to include in the count results (e.g., ['type', 'platform'])
Network Alert Tools
create_alert
Create a persistent Shodan network alert that monitors one or more IPs/ranges and reports changes over time. This is not a read-only action.
Parameters:
name(required): Descriptive name for the alertip(required): List of IPs or CIDR ranges to monitor (e.g., ['1.2.3.4', '10.0.0.0/24'])expires(optional): Number of seconds the alert should stay active before automatically expiring (omit for no expiration)
list_alerts
List all configured Shodan network alerts on the account.
Parameters:
include_expired(optional): Whether to include expired alerts in the results (default: true)
get_alert
Get details about a specific Shodan network alert by ID.
Parameters:
alert_id(required): ID of the alert to retrieve
delete_alert
Permanently delete a Shodan network alert by ID. This is a destructive action and cannot be undone.
Parameters:
alert_id(required): ID of the alert to delete
Notifier Tools
list_notifier_providers
List available Shodan notifier providers (e.g. slack, email, webhook, telegram) and the arguments each one requires.
Parameters: None
list_notifiers
List all configured Shodan notifiers on the account.
Parameters: None
create_notifier
Create a new Shodan notifier (e.g. Slack, email, webhook) that network alerts can send events to. This is not a read-only action.
Parameters:
provider(required): Notifier provider name (e.g. 'slack', 'email', 'webhook', 'telegram'). Uselist_notifier_providersto see available options.args(required): Provider-specific arguments (e.g.,{"webhook_url": "https://..."}for slack)description(optional): Human-readable description of the notifier
delete_notifier
Permanently delete a Shodan notifier by ID. This is a destructive action and cannot be undone.
Parameters:
notifier_id(required): ID of the notifier to delete
Account & Utility Tools
get_api_info
Get information about your API plan including credits and limits.
Parameters: None
get_account_profile
Get account profile information including membership status and credits.
Parameters: None
get_my_ip
Get your current IP address as seen from the Internet.
Parameters: None
Available Resources
shodan://host/{ip}: Information about a specific IP address
API Limitations
Some Shodan API endpoints require a paid membership. The following features are only available with a paid Shodan API key:
Search functionality (search_shodan, scan_network_range, get_ssl_info, search_iot_devices, get_host_count, get_domain_info)
Network scanning
SSL certificate lookup
IoT device search
Exploit search (search_exploits, count_exploits)
Network alerts and notifiers (create_alert, list_alerts, get_alert, delete_alert, list_notifier_providers, list_notifiers, create_notifier, delete_notifier)
Note: CVE database functionality (get_cve_info, search_cves, get_cpes, get_newest_cves, get_kev_cves, get_cves_by_epss) is completely free and does not require a paid Shodan subscription.
Note: get_internetdb_host is completely free and does not require a Shodan API key at all — it queries the public internetdb.shodan.io service directly. The server still requires a SHODAN_API_KEY environment variable to start (used by the other tools).
License
MIT
Developed by
Citation
If you use this project in your research or publications, please cite it as follows:
author = {Bassem Abidi and Moudather Chelbi},
title = {Shodan MCP Server},
year = {2025},
howpublished = {https://github.com/Cyreslab-AI/shodan-mcp-server},
note = {Accessed: 2025-06-29}Available Tools
23 toolsdns_lookupB
Resolve hostnames to IP addresses using DNS lookup
Inputs: hostnames (required).
get_account_profileB
Get account profile information including membership status and credits
Inputs: no named parameters.
get_api_infoB
Get information about your API plan including credits and limits
Inputs: no named parameters.
get_cpesC
Get Common Platform Enumeration (CPE) information for products
Inputs: product, vendor, version, limit, +1 more.
get_cve_infoC
Get detailed information about a specific CVE
Inputs: cve_id (required).
get_cves_by_epssC
Get CVEs sorted by EPSS score (Exploit Prediction Scoring System)
Inputs: limit.
get_domain_infoC
Get comprehensive domain information including subdomains and DNS records
Inputs: domain (required), history, type, page.
get_host_countA
Get the count of hosts matching a search query without consuming query credits
Inputs: query (required), facets.
get_host_infoC
Get detailed information about a specific IP address
Inputs: ip (required), max_items, fields.
get_kev_cvesB
Get Known Exploited Vulnerabilities (KEV) from CISA
Inputs: limit.
get_my_ipA
Get your current IP address as seen from the Internet
Inputs: no named parameters.
get_newest_cvesB
Get the newest vulnerabilities from the CVE database
Inputs: limit.
get_ssl_infoC
Get SSL certificate information for a domain
Inputs: domain (required).
list_portsB
List all ports that Shodan crawls on the Internet
Inputs: no named parameters.
list_protocolsA
List all protocols that can be used when performing on-demand Internet scans
Inputs: no named parameters.
list_search_facetsA
List all available search facets that can be used with Shodan queries
Inputs: no named parameters.
list_search_filtersB
List all available search filters that can be used in Shodan queries
Inputs: no named parameters.
parse_search_tokensC
Parse a search query to understand which filters and parameters are being used
Inputs: query (required).
reverse_dns_lookupC
Get hostnames for IP addresses using reverse DNS lookup
Inputs: ips (required).
scan_network_rangeC
Scan a network range (CIDR notation) for devices
Inputs: cidr (required), max_items, fields.
search_cvesC
Search for vulnerabilities with various filters
Inputs: cpe23, product, is_kev, sort_by_epss, +4 more.
search_iot_devicesC
Search for specific types of IoT devices
Inputs: device_type (required), country, max_items.
search_shodanC
Search Shodan's database for devices and services
Inputs: query (required), page, facets, max_items, +2 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 23 tools
Most tools have distinct purposes, but there is some overlap between search tools (search_shodan, search_iot_devices, search_cves) and informational tools (get_cves_by_epss, get_newest_cves, get_kev_cves) that could cause confusion. Descriptions help clarify, but the boundaries between general and specific search/query tools are not perfectly clear.
Tool names follow a highly consistent verb_noun pattern throughout, such as get_account_profile, list_ports, search_shodan, and parse_search_tokens. There are no deviations in naming conventions, making the set predictable and easy to understand.
With 23 tools, the count is borderline high for a Shodan server, which might feel heavy for agents to navigate efficiently. While it covers many aspects of Shodan's functionality, some tools could potentially be consolidated or omitted without losing core capabilities.
The tool set provides comprehensive coverage for Shodan's domain, including account management, host and domain lookups, vulnerability searches, network scanning, and query parsing. There are no obvious gaps; it supports full CRUD-like operations and lifecycle management for security research tasks.
Maintenance
Related MCP Connectors
Defensive Shodan search and host intelligence MCP using customer-provided SHODAN_API_KEY for
Unofficial Shodan InternetDB MCP — wraps Shodan InternetDB (internetdb.shodan.io)
Unofficial Shodan MCP — wraps the full Shodan REST API (api.shodan.io)
Agentic cybersecurity tool: URL phishing/malware scanning and more.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables comprehensive security reconnaissance, vulnerability assessment, and threat intelligence gathering by integrating Shodan's API. It provides tools for searching internet-connected devices, performing DNS operations, and querying the Shodan exploit database.11Apache 2.0
- AlicenseBqualityFmaintenanceProvides access to Shodan's IoT search engine API for device search, host intelligence, exploit database, network scanning, and security analysis through natural language.32MIT
- AlicenseNot gradedqualityCmaintenanceEnables to search and analyze internet-connected devices using the Shodan API, with tools for host search, DNS, scanning, exploits, alerts, and more.MIT
- AlicenseNot gradedqualityCmaintenanceWraps the full Shodan REST API to allow AI agents to search and retrieve Shodan data through natural language.300 npmMIT