Shodan
A Model Context Protocol server that provides access to Shodan API functionality.
3.9K
5 Tools
Packaged by
Requires Secrets
Add to Docker Desktop
Version 4.43 or later needs to be installed to add the server automatically
About
Shodan MCP Server
A Model Context Protocol server that provides access to Shodan API functionality.
Characteristics
| Attribute | Details |
|---|---|
| Docker Image | mcp/cyreslab-ai-shodan |
| Author | Cyreslab-AI |
| Repository | https://github.com/Cyreslab-AI/shodan-mcp-server |
| Dockerfile | https://github.com/Cyreslab-AI/shodan-mcp-server/blob/935f7044f60570cf2d094d94596eeea7872fb6be/Dockerfile |
| Docker Image built by | Docker Inc. |
| Docker Scout Health Score | |
| Verify Signature | COSIGN_REPOSITORY=mcp/signatures cosign verify mcp/cyreslab-ai-shodan --key https://raw.githubusercontent.com/docker/keyring/refs/heads/main/public/mcp/latest.pub |
| Licence | MIT License |
Available Tools (5)
| Tools provided by this Server | Short Description |
|---|---|
get_host_info | Get detailed information about a specific IP address |
get_ssl_info | Get SSL certificate information for a domain |
scan_network_range | Scan a network range (CIDR notation) for devices |
search_iot_devices | Search for specific types of IoT devices |
search_shodan | Search Shodan's database for devices and services |
Tools Details
Tool: get_host_info
Get detailed information about a specific IP address
| Parameters | Type | Description |
|---|---|---|
ip | string | IP address to look up |
fields | arrayoptional | List of fields to include in the results (e.g., ['ip_str', 'ports', 'location.country_name']) |
max_items | numberoptional | Maximum number of items to include in arrays (default: 5) |
Tool: get_ssl_info
Get SSL certificate information for a domain
| Parameters | Type | Description |
|---|---|---|
domain | string | Domain name to look up SSL certificates for (e.g., example.com) |
Tool: scan_network_range
Scan a network range (CIDR notation) for devices
| Parameters | Type | Description |
|---|---|---|
cidr | string | Network range in CIDR notation (e.g., 192.168.1.0/24) |
fields | arrayoptional | List of fields to include in the results (e.g., ['ip_str', 'ports', 'location.country_name']) |
max_items | numberoptional | Maximum number of items to include in results (default: 5) |
Tool: search_iot_devices
Search for specific types of IoT devices
| Parameters | Type | Description |
|---|---|---|
device_type | string | Type of IoT device to search for (e.g., 'webcam', 'router', 'smart tv') |
country | stringoptional | Optional country code to limit search (e.g., 'US', 'DE') |
max_items | numberoptional | Maximum number of items to include in results (default: 5) |
Tool: search_shodan
Search Shodan's database for devices and services
| Parameters | Type | Description |
|---|---|---|
query | string | Shodan search query (e.g., 'apache country:US') |
facets | arrayoptional | List of facets to include in the search results (e.g., ['country', 'org']) |
fields | arrayoptional | List of fields to include in the results (e.g., ['ip_str', 'ports', 'location.country_name']) |
max_items | numberoptional | Maximum number of items to include in arrays (default: 5) |
page | numberoptional | Page number for results pagination (default: 1) |
summarize | booleanoptional | Whether to return a summary of the results instead of the full data (default: false) |
Use this MCP Server
{
"mcpServers": {
"cyreslab-ai-shodan": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"SHODAN_API_KEY",
"mcp/cyreslab-ai-shodan"
],
"env": {
"SHODAN_API_KEY": "YOUR_SHODAN_API_KEY"
}
}
}
}
Manual installation
You can install the MCP server using:
Installation for