# Shodan (MCP server)

> Shodan is an MCP server that adds tools to AI assistants such as Claude Desktop, Claude Code and Cursor. MCP server for Shodan API — device search, IP lookup, DNS, and CVE/CPE queries. It has 174 GitHub stars, is released under the MIT license and runs locally with npx -y @burtthecoder/mcp-shodan.

A Model Context Protocol (MCP) server for querying the Shodan API and Shodan CVEDB. This server provides comprehensive access to Shodan's network intelligence and security services, including IP reconnaissance, DNS operations, vulnerability tracking, and device discovery. All tools provide structured, formatted output for easy analysis and integration.

## Key facts

| Fact | Value |
|---|---|
| Repository | https://github.com/w0h1v/mcp-shodan |
| GitHub stars | 174 |
| License | MIT |
| Language | TypeScript |
| Transport | stdio |
| Packages | npm: @burtthecoder/mcp-shodan |
| Remote URL | none |
| Needs API key | yes |
| Official | no |
| Works with | Claude Desktop, Claude Code, Cursor, VS Code |
| Category | Other |
| Latest release | v1.0.30 (Sep 8, 2026) |
| Last commit | Sep 8, 2026 |
| MCP registry name | io.github.BurtTheCoder/shodan |

## Install

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "shodan": {
      "command": "npx",
      "args": [
        "-y",
        "@burtthecoder/mcp-shodan"
      ],
      "env": {
        "SHODAN_API_KEY": "your-value"
      }
    }
  }
}
```

Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.

### Claude Code

```sh
claude mcp add --env SHODAN_API_KEY=your-value --transport stdio shodan -- npx -y @burtthecoder/mcp-shodan
```

### Cursor (.cursor/mcp.json)

```json
{
  "mcpServers": {
    "shodan": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@burtthecoder/mcp-shodan"
      ],
      "env": {
        "SHODAN_API_KEY": "your-value"
      }
    }
  }
}
```

Project file; use ~/.cursor/mcp.json to enable it in every project.

### VS Code (.vscode/mcp.json)

```json
{
  "inputs": [
    {
      "type": "promptString",
      "id": "shodan_api_key",
      "description": "SHODAN_API_KEY",
      "password": true
    }
  ],
  "servers": {
    "shodan": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@burtthecoder/mcp-shodan"
      ],
      "env": {
        "SHODAN_API_KEY": "${input:shodan_api_key}"
      }
    }
  }
}
```

Config formats checked against the official docs on 2026-10-07.

## Environment variables

- `SHODAN_API_KEY` (secret) (required): Your Shodan API key

## Tools

- `query`: Shodan search query
- `max_results`: Number of results to return
- `hostnames`: Array of hostnames to resolve
- `product`: Name of the product to search for
- `count`: If true, returns only the count of matching CPEs
- `skip`: Number of CPEs to skip (for pagination)
- `limit`: Maximum number of CPEs to return
- `cpe23`: CPE 2.3 identifier (format: cpe:2.3:part:vendor:product:version)
- `is_kev`: If true, returns only CVEs with KEV flag set
- `sort_by_epss`: If true, sorts CVEs by EPSS score
- `start_date`: Start date for filtering CVEs (format: YYYY-MM-DDTHH:MM:SS)
- `end_date`: End date for filtering CVEs (format: YYYY-MM-DDTHH:MM:SS)

## Similar MCP servers

- [Reactive Resume](https://appsgit.com/mcp-servers/reactive-resume): A one-of-a-kind resume builder that keeps your privacy in mind. (43,921 stars, MIT)
- [N8n MCP](https://appsgit.com/mcp-servers/n8n-mcp): A MCP for Claude Desktop / Claude Code / Windsurf / Cursor to build n8n workflows for you. (23,047 stars, MIT)
- [XHS Downloader](https://appsgit.com/mcp-servers/xhs-downloader): 小红书（XiaoHongShu、RedNote）链接提取/作品采集工具. (12,922 stars, GPL-3.0)
- [MCP Use](https://appsgit.com/mcp-servers/mcp-use): The fullstack MCP framework to develop MCP Apps for ChatGPT / Claude & MCP Servers for AI Agents. (10,726 stars, MIT)
- [Ha MCP](https://appsgit.com/mcp-servers/ha-mcp): Comprehensive Model Context Protocol server for managing Home Assistant through AI assistants. (4,964 stars, MIT)
- [MCP Server Chart](https://appsgit.com/mcp-servers/mcp-server-chart): A Model Context Protocol server for generating charts using AntV. (4,391 stars, MIT, needs API key)

---

Canonical page: https://appsgit.com/mcp-servers/shodan
Source: appsgit (https://appsgit.com), the app store for github. Data from the GitHub API, refreshed nightly.
Machine access: JSON API https://appsgit.com/api/v1/apps (OpenAPI: https://appsgit.com/openapi.json), MCP server https://mcp.appsgit.com/mcp, full index https://appsgit.com/llms-full.txt.