daedalus avatar

Mcp Shodan

daedalus/mcp-shodan

Connects Claude to the Shodan API for programmatic access to internet-connected device data. You get the full range of Shodan operations: host lookups, database searches with cursor support, alert management, network scanning, exploit archive queries, and saved query browsing. Requires a Shodan API key. Reach for this when you need Claude to investigate exposed services, assess internet-facing infrastructure, or pull vulnerability intelligence during security assessments. The comprehensive tool set means you can go from broad searches to specific host enumeration without switching contexts.

GitHub stars
1
tools
20
transport
STDIO
last updated
Apr 4, 2026

Tools

20 tools

Public tool metadata for what this MCP can expose to an agent.

shodan_hostGet all available information on an IP address

Get all available information on an IP address

No parameter schema in public metadata yet.

shodan_searchSearch the Shodan database

Search the Shodan database

No parameter schema in public metadata yet.

shodan_search_cursorSearch and return an iterator

Search and return an iterator

No parameter schema in public metadata yet.

shodan_countGet total number of search results

Get total number of search results

No parameter schema in public metadata yet.

shodan_search_tokensGet information about a search query

Get information about a search query

No parameter schema in public metadata yet.

shodan_alertsList all active alerts

List all active alerts

No parameter schema in public metadata yet.

shodan_create_alertCreate a new alert

Create a new alert

No parameter schema in public metadata yet.

shodan_delete_alertDelete an alert

Delete an alert

No parameter schema in public metadata yet.

shodan_scanScan a network

Scan a network

No parameter schema in public metadata yet.

shodan_scan_internetScan the internet on a port

Scan the internet on a port

No parameter schema in public metadata yet.

shodan_scan_statusGet scan status

Get scan status

No parameter schema in public metadata yet.

shodan_queriesList shared search queries

List shared search queries

No parameter schema in public metadata yet.

shodan_queries_searchSearch saved queries

Search saved queries

No parameter schema in public metadata yet.

shodan_queries_tagsGet popular query tags

Get popular query tags

No parameter schema in public metadata yet.

shodan_exploits_searchSearch the Shodan Exploits archive

Search the Shodan Exploits archive

No parameter schema in public metadata yet.

shodan_exploits_countGet total exploit count

Get total exploit count

No parameter schema in public metadata yet.

shodan_infoGet API key information

Get API key information

No parameter schema in public metadata yet.

shodan_portsGet list of ports Shodan crawls

Get list of ports Shodan crawls

No parameter schema in public metadata yet.

shodan_protocolsGet supported protocols

Get supported protocols

No parameter schema in public metadata yet.

shodan_servicesGet list of services

Get list of services

No parameter schema in public metadata yet.

Sponsors

Readme

mcp-shodan

MCP server exposing Shodan API functionality via the Model Context Protocol.

PyPI Python Coverage Ruff

Install

pip install mcp-shodan

Usage

export SHODAN_API_KEY=your_api_key
mcp-shodan

Or 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

View the full README on GitHub

Details

Repository
github.com/daedalus/mcp-shodan
Package
mcp-shodan
Transport
STDIO
Registry
MCP registry, active

More from daedalus