English Français العربية

io.github.daedalus/mcp-shodan

Official registry Other

MCP server exposing all Shodan API functionality

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

PYPI package mcp-shodan
Claude Code 
claude mcp add mcp-shodan -- uvx mcp-shodan==0.1.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "mcp-shodan": {
            "command": "uvx",
            "args": [
                "mcp-shodan==0.1.0"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. mcp-shodan
  2. Install
  3. Usage
  4. Available Tools
  5. Example

mcp-shodan

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

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
  • shodan_search - Search the Shodan database
  • shodan_search_cursor - Search and return an iterator
  • shodan_count - Get total number of search results
  • shodan_search_tokens - Get information about a search query
Alerts
  • shodan_alerts - List all active alerts
  • shodan_create_alert - Create a new alert
  • shodan_delete_alert - Delete an alert
Scanning
  • shodan_scan - Scan a network
  • shodan_scan_internet - Scan the internet on a port
  • shodan_scan_status - Get scan status
Saved Queries
  • shodan_queries - List shared search queries
  • shodan_queries_search - Search saved queries
  • shodan_queries_tags - Get popular query tags
Exploits
  • shodan_exploits_search - Search the Shodan Exploits archive
  • shodan_exploits_count - Get total exploit count
Utilities
  • shodan_info - Get API key information
  • shodan_ports - Get list of ports Shodan crawls
  • shodan_protocols - Get supported protocols
  • shodan_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

Frequently asked questions

What is io.github.daedalus/mcp-shodan?

MCP server exposing all Shodan API functionality

How do I install io.github.daedalus/mcp-shodan?

It runs on your machine. In Claude Code: claude mcp add mcp-shodan -- uvx mcp-shodan==0.1.0. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.daedalus/mcp-shodan need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.daedalus/mcp-shodan open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.daedalus/mcp-shodan?

It is published by daedalus. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.