Overview
What is Shodan MCP Server?
Shodan MCP Server is a Model Context Protocol (MCP) server that provides access to the Shodan API, enabling AI assistants to query information about internet-connected devices and services.
How to use Shodan MCP Server?
Install dependencies with npm install, build with npm run build, set the SHODAN_API_KEY environment variable, and start with npm start. For integration with Claude, add the server to your MCP settings JSON with the command node, the path to build/index.js, and the Shodan API key in the env object.
Key features of Shodan MCP Server
- Get detailed host information for specific IP addresses
- Search Shodan’s database for devices and services
- Scan network ranges in CIDR notation for devices
- Obtain SSL certificate details for domains
- Search for specific types of IoT devices
Use cases of Shodan MCP Server
- Look up host information for a given IP using
get_host_info - Search for internet-connected devices or services with
search_shodan - Scan a network range for devices via
scan_network_range - Retrieve SSL certificate data for a domain using
get_ssl_info - Identify specific IoT device types globally or by country with
search_iot_devices
FAQ from Shodan MCP Server
What API key is required?
A Shodan API key must be set as the SHODAN_API_KEY environment variable before starting the server.
Are all features available with a free Shodan API key?
No. Search, network scanning, SSL certificate lookup, and IoT device search require a paid Shodan API membership.
How do I integrate Shodan MCP Server with Claude?
Add the server to your MCP settings file with command: "node", args pointing to build/index.js, and the SHODAN_API_KEY in the env block, then restart Claude.
What tools does Shodan MCP Server provide?
Five tools: get_host_info, search_shodan, scan_network_range, get_ssl_info, and search_iot_devices.
What resource is available?
The resource shodan://host/{ip} provides information about a specific IP address.
