mcp-shodan
MCP server exposing Shodan API functionality via the Model Context Protocol.
   
Install
pip install mcp-shodanUsage
export SHODAN_API_KEY=your_api_key
mcp-shodanOr add to your MCP configuration:
{
"mcpServers": {
"shodan": {
"command": "mcp-shodan",
"env": {
"SHODAN_API_KEY": "your_api_key"
}
}
}
}Available Tools
Host Information
shodan_host- Get all available information on an IP address
Search
shodan_search- Search the Shodan databaseshodan_search_cursor- Search and return an iteratorshodan_count- Get total number of search resultsshodan_search_tokens- Get information about a search query
Alerts
shodan_alerts- List all active alertsshodan_create_alert- Create a new alertshodan_delete_alert- Delete an alert
Scanning
shodan_scan- Scan a networkshodan_scan_internet- Scan the internet on a portshodan_scan_status- Get scan status
Saved Queries
shodan_queries- List shared search queriesshodan_queries_search- Search saved queriesshodan_queries_tags- Get popular query tags
Exploits
shodan_exploits_search- Search the Shodan Exploits archiveshodan_exploits_count- Get total exploit count
Utilities
shodan_info- Get API key informationshodan_ports- Get list of ports Shodan crawlsshodan_protocols- Get supported protocolsshodan_services- Get list of services
Example
# Get information about a host
shodan_host("1.1.1.1")
# Search for specific services
shodan_search("apache", limit=10)
# Count results for a query
shodan_count("nginx")
# Check your API plan
shodan_info()mcp-name: io.github.daedalus/mcp-shodan
