shodan-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@shodan-mcp search for cameras in the United States"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
shodan-mcp
Serwer MCP udostepniajacy API Shodan.IO, oparty o FastMCP i oficjalna biblioteke shodan-python.
Wymagania
Python 3.13+
Klucz API Shodan
Related MCP server: Shodan MCP Server
Instalacja
uv syncKonfiguracja klucza API
Klucz pobierany jest wylacznie ze zmiennej srodowiskowej SHODAN_API_KEY.
Nie zapisuj klucza w repozytorium. Do lokalnych testow skopiuj .env.example do .env.
Uruchomienie
Transport: stdio (domyslny dla lokalnego Claude Code / Claude Desktop).
SHODAN_API_KEY=... uv run server.pyKonfiguracja klienta MCP
Przyklad wpisu (.mcp.json lub claude mcp add):
{
"mcpServers": {
"shodan": {
"command": "uv",
"args": ["run", "--directory", "/home/ra/secra/shodan-mcp", "server.py"]
}
}
}Tool: search
Generalne wyszukiwanie przez API Shodan. Laczy wolny tekst (query) z opcjonalnymi
filtrami-dorkami, ktore tool sklada w finalne zapytanie Shodan.
Obslugiwane filtry: org, hostname, net, ip, port, country, city,
product, version, os, asn, isp, title (http.title), http_status
(http.status), ssl, vuln, tag, after, before, has_screenshot.
Dodatkowe parametry: page (strona wynikow), facets (agregacje, np. port:10,org:5),
raw (gdy true, zwraca pelny surowy JSON zamiast przycietego zestawu pol).
Przyklad: query="nginx", country="PL", port=443 -> zapytanie nginx country:PL port:443.
Tool: host
Lookup po adresie IP. Zwraca szczegoly hosta (org, isp, asn, lokalizacja, porty, tagi, podatnosci) oraz liste wykrytych uslug.
Parametry: ip (wymagany), history (pelna historia banerow), minify (okrojony
zestaw pol), raw (pelny surowy JSON zamiast przycietego).
Roadmap
Kolejne toole: count (sam licznik), search_cursor (paginacja kursorowa),
scan / alerts.
Available Tools
2 toolshostA
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).
Inputs: ip (required), raw, minify, history. Returns: object
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.
Inputs: ip, os, asn, isp, +20 more. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
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.
Maintenance
Related MCP Connectors
Defensive Shodan search and host intelligence MCP using customer-provided SHODAN_API_KEY for
Unofficial Shodan MCP — wraps the full Shodan REST API (api.shodan.io)
Unofficial Shodan InternetDB MCP — wraps Shodan InternetDB (internetdb.shodan.io)
Interact with the Stitch API using natural language commands.
Related MCP Servers
- AlicenseBqualityCmaintenanceProvides access to Shodan API functionality, enabling AI assistants to query information about internet-connected devices for cybersecurity research and threat intelligence.2355MIT
- AlicenseAqualityDmaintenanceEnables comprehensive security reconnaissance, vulnerability assessment, and threat intelligence gathering by integrating Shodan's API. It provides tools for searching internet-connected devices, performing DNS operations, and querying the Shodan exploit database.11Apache 2.0
- AlicenseBqualityFmaintenanceProvides access to Shodan's IoT search engine API for device search, host intelligence, exploit database, network scanning, and security analysis through natural language.32MIT
- AlicenseNot gradedqualityCmaintenanceEnables to search and analyze internet-connected devices using the Shodan API, with tools for host search, DNS, scanning, exploits, alerts, and more.MIT