Back to Browse

Shodan MCP Server

Developer ToolsUse Caution4.5MCP RegistryLocal
Free

Server data from the Official MCP Registry

MCP server exposing all Shodan API functionality

About

MCP server exposing all Shodan API functionality

Security Report

4.5
Use Caution4.5High Risk

Valid MCP server (3 strong, 4 medium validity signals). 5 known CVEs in dependencies (1 critical, 3 high severity) Package registry verified. Imported from the Official MCP Registry.

8 files analyzed · 6 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

env_vars

Check that this permission is expected for this type of plugin.

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-daedalus-mcp-shodan": {
      "args": [
        "mcp-shodan"
      ],
      "command": "uvx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub 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

Search

  • 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

Reviews

No reviews yet

Be the first to review this server!