mcpField
M
mcp-shodan

mcp-shodan

Local
github.com/daedalusSecurity1Updated 27w ago
Repository

About mcp-shodan

mcp-shodan exposes Shodan API operations to security analysts and other MCP clients. Its tools cover host lookups, database searches, alerts, scans, saved queries, exploits, and API utilities.

Key features

  1. 01Retrieve information about an IP host
  2. 02Search Shodan and count results
  3. 03Manage alerts and network scans
  4. 04Find saved queries and query tags
  5. 05Search the Shodan Exploits archive
  6. 06Inspect API, port, protocol, and service information

Use cases

  1. 01Look up exposed services on an IP address
  2. 02Search or count hosts matching a query
  3. 03Create alerts or check scan status
  4. 04Search saved queries or exploit records

MCP support

This MCP server exposes Shodan API functionality as tools for MCP clients, including host information, search, alerts, scanning, saved queries, and exploit lookups. It uses a Shodan API key.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "daedalus-mcp-shodan": {
      "command": "uvx",
      "args": [
        "mcp-shodan"
      ]
    }
  }
}
Run commanduvx mcp-shodan

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
pypimcp-shodan0.1.0

Tools

20

Saved tool list · updated 2w ago

ParameterTypeRequiredDescription
ipstringYesIP address of the computer.
minifybooleanNoTrue to only return the list of ports and general host information.
historybooleanNoTrue if you want to grab the historical banners for the host.

Details

From the project 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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.