shodan-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| SHODAN_API_KEY | Yes | Klucz API Shodan wymagany do autoryzacji. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| logging | {} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| extensions | {
"io.modelcontextprotocol/ui": {}
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| searchA | Wyszukiwanie w Shodan. Laczy wolny 'query' z opcjonalnymi filtrami-dorkami. Parametry: query: wolny tekst zapytania (np. "nginx"). Moze byc pusty, jesli podano filtry. org: filtr org: (organizacja / wlasciciel). hostname: filtr hostname:. net: filtr net: (zakres CIDR, np. 1.2.3.0/24). ip: filtr ip:. port: filtr port:. country: filtr country: (kod ISO, np. PL). city: filtr city:. product: filtr product: (np. nginx). version: filtr version:. os: filtr os:. asn: filtr asn: (np. AS12345). isp: filtr isp:. title: filtr http.title:. http_status: filtr http.status:. ssl: filtr ssl:. vuln: filtr vuln: (wymaga odpowiedniego planu Shodan). tag: filtr tag:. after: filtr after: (data dd/mm/yyyy). before: filtr before: (data dd/mm/yyyy). has_screenshot: filtr has_screenshot:. page: numer strony wynikow (100 wynikow na strone). facets: agregacje, np. "port:10,org:5". raw: gdy True zwraca pelny surowy JSON z Shodan zamiast przycietego. Zwraca slownik z liczba wynikow (total), lista dopasowan (matches) oraz facets. |
| hostA | Zwraca szczegolowe informacje o adresie IP z bazy Shodan. Parametry: ip: adres IP do sprawdzenia. history: gdy True zwraca pelna historie banerow (a nie tylko ostatnie). minify: gdy True prosi Shodan o okrojony zestaw danych (szybciej, mniej pol). raw: gdy True zwraca pelny surowy JSON z Shodan zamiast przycietego. Zwraca slownik z danymi hosta (org, isp, asn, lokalizacja, porty, tagi, podatnosci) oraz lista wykrytych uslug (services). |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 2 tools
The 'host' and 'search' tools have clearly distinct purposes: one retrieves details for a specific IP, the other performs general queries with filters. No overlap.
Both tool names are single lowercase verbs ('host', 'search') following a consistent simple pattern. No mixing of styles.
With only 2 tools, the set feels thin for a comprehensive Shodan interface. While it covers basic operations, more tools (e.g., count, DNS) would improve scope.
The tools cover core Shodan functionality (IP lookup and search), but missing common operations like count or streaming. A minor gap for a minimal server.