Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| SHODAN_API_KEY | Yes | Your Shodan API key, obtained from https://account.shodan.io/ |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| shodan_host_search | Search Shodan for hosts matching a query. Returns detailed information about discovered hosts including IP addresses, ports, services, and vulnerabilities. Use for asset discovery and reconnaissance. ICS/SCADA Examples:
Effective Patterns:
|
| shodan_host_info | Get detailed information about a specific host by IP address. Returns all services, open ports, vulnerabilities, and historical data. |
| shodan_dns_lookup | Perform DNS lookups to resolve domain names to IP addresses. |
| shodan_dns_reverse | Reverse DNS lookup to find hostnames associated with IP addresses. |
| shodan_api_info | Get information about the current API plan including query credits remaining and scan credits. |
| shodan_exploits_search | Search for exploits in the Shodan Exploits database. Useful for finding known exploits for specific CVEs or software. Critical for ICS/SCADA security assessments. ICS/SCADA Exploit Examples:
Common ICS CVE Searches:
|
| shodan_ports | Get a list of port numbers that Shodan crawls on the Internet. Useful for discovering what protocols are monitored. Key ICS/SCADA Ports in Shodan:
Use this to verify Shodan monitors your target protocol. |
| shodan_protocols | Get information about the protocols that Shodan supports for querying. |
| shodan_count | Get the total number of results for a search query without returning the actual results. Useful for scoping searches before running full queries to avoid wasting API credits. Best Practice: Always use count first for large ICS/SCADA queries. Example Workflow:
Use with facets to see distribution without burning credits on full results. |
| shodan_query_search | Search for saved Shodan queries shared by the community. Useful for discovering popular query patterns and learning effective search techniques. Popular ICS/SCADA Query Topics:
Use community queries to:
|
| shodan_query_tags | Get a list of popular tags for saved Shodan queries. Tags help discover trending search topics and common query categories. Common ICS/SCADA Related Tags:
Use to browse popular query categories and discover new search angles. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |