Enterprise DNAEnterprise DNA

MCP Servers

BurtTheCoder/mcp-shodan

MCP server for Shodan — search internet-connected devices, IP reconnaissance, DNS lookups, and CVE/CPE vulnerability intelligence.

Our verdict

Not reviewed yet

We have not reviewed BurtTheCoder/mcp-shodan yet

No one at Enterprise DNA has checked this listing against its sources. The description comes from public listings gathered automatically. Any fact below shows where it came from and when it was last checked.

How we review records

From the listing

About BurtTheCoder/mcp-shodan

This MCP server provides a bridge between AI coding assistants and Shodan's search engine for internet-connected devices. It enables IP reconnaissance, DNS lookups, and vulnerability intelligence via CVE/CPE queries. The server works with Claude Code, Codex, Gemini CLI, and Claude Desktop.

Best for

Developers and security researchers needing Shodan data in AI coding assistants

Use cases

  • IP reconnaissance and device discovery
  • DNS lookups and geolocation of network infrastructure
  • CVE/CPE vulnerability lookup for exposed services

Notes

133 stars on GitHub. Last updated 2026-03-31. Licensed MIT.

Pros

  • Works with multiple AI assistant CLIs (Claude Code, Codex, Gemini CLI, Claude Desktop)
  • Accesses Shodan's comprehensive internet device search and vulnerability data
  • Lightweight TypeScript MCP server easy to integrate

Cons

  • Requires a paid Shodan API key for full functionality
  • Limited to internet-exposed devices indexed by Shodan
  • Depends on MCP protocol compatibility (requires supporting client)

Key facts

What we have checked

Days since the last commit
3
Checked GitHub
GitHub forks
31
Checked GitHub
GitHub stars
188
Checked GitHub
Open issues
0
Checked GitHub
Releases in the last 90 days
1
Checked GitHub

Each value shows when we last confirmed it and where it came from. Values we have not confirmed are left out, never guessed.

How to use

How to set it up

As the listing publishes it. We have not run this install.

Install

npx fastmcp dev build/index.js    # try tools interactively (needs SHODAN_API_KEY)

Tools exposed

  • SHODAN_API_KEY
  • MCP_TRANSPORT
  • MCP_HOST
  • MCP_PORT
  • MCP_ENDPOINT

Clients the listing names (not checked here)

Claude Desktop, Claude Code, VS Code

Example client config

{
  "mcpServers": {
    "shodan": {
      "command": "mcp-shodan",
      "env": {
        "SHODAN_API_KEY": "your-shodan-api-key"
      }
    }
  }
}

Install

Add BurtTheCoder/mcp-shodan to your client

Not verified yet

Our lab has not run this server yet. "Config checked" on a client means the recipe matches that client's documented config format; it does not mean we ran it.

Claude Code

Config checked

Run in your terminal (runs on your computer)

claude mcp add --env SHODAN_API_KEY=YOUR_SHODAN_API_KEY --transport stdio burtthecoder-mcp-shodan -- npx -y @burtthecoder/mcp-shodan@1.0.22

Needs SHODAN_API_KEY: replace each YOUR_ value with your own.

Version 1.0.22 · From the Official MCP registry, read · Format checked against Claude Code's config docs

Claude Desktop

Config checked

Add to claude_desktop_config.json (runs on your computer)

{
  "mcpServers": {
    "burtthecoder-mcp-shodan": {
      "command": "npx",
      "args": [
        "-y",
        "@burtthecoder/mcp-shodan@1.0.22"
      ],
      "env": {
        "SHODAN_API_KEY": "YOUR_SHODAN_API_KEY"
      }
    }
  }
}

Needs SHODAN_API_KEY: replace each YOUR_ value with your own.

Version 1.0.22 · From the Official MCP registry, read · Format checked against Claude Desktop's config docs

Cursor

Config checked

Add to .cursor/mcp.json (runs on your computer)

{
  "mcpServers": {
    "burtthecoder-mcp-shodan": {
      "command": "npx",
      "args": [
        "-y",
        "@burtthecoder/mcp-shodan@1.0.22"
      ],
      "env": {
        "SHODAN_API_KEY": "YOUR_SHODAN_API_KEY"
      }
    }
  }
}

Needs SHODAN_API_KEY: replace each YOUR_ value with your own.

Version 1.0.22 · From the Official MCP registry, read · Format checked against Cursor's config docs

VS Code

Config checked

Add to .vscode/mcp.json (runs on your computer)

{
  "inputs": [
    {
      "type": "promptString",
      "id": "shodan-api-key",
      "description": "Your Shodan API key",
      "password": true
    }
  ],
  "servers": {
    "burtthecoder-mcp-shodan": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@burtthecoder/mcp-shodan@1.0.22"
      ],
      "env": {
        "SHODAN_API_KEY": "${input:shodan-api-key}"
      }
    }
  }
}

Needs SHODAN_API_KEY: replace each YOUR_ value with your own.

Version 1.0.22 · From the Official MCP registry, read · Format checked against VS Code's config docs

Codex

Config checked

Add to ~/.codex/config.toml (runs on your computer)

[mcp_servers.burtthecoder-mcp-shodan]
command = "npx"
args = ["-y", "@burtthecoder/mcp-shodan@1.0.22"]
env_vars = ["SHODAN_API_KEY"]

Needs SHODAN_API_KEY: replace each YOUR_ value with your own.

Version 1.0.22 · From the Official MCP registry, read · Format checked against Codex's config docs

  • ChatGPT: ChatGPT connects only to remote servers that need no API key.

Recipes come from the server's entry in the official MCP registry. Check the package name before you run it, and keep keys out of shared files.

Works with

What BurtTheCoder/mcp-shodan connects to

5 clients, each with how we know and when we checked.

Works withTypeHow we knowChecked
Claude CodeClientInstall recipe matches the client's documented formatRuns locally, version 1.0.22Config checkedClaude Code docs
Claude DesktopClientInstall recipe matches the client's documented formatRuns locally, version 1.0.22Config checkedClaude Desktop docs
CursorClientInstall recipe matches the client's documented formatRuns locally, version 1.0.22Config checkedCursor docs
VS CodeClientInstall recipe matches the client's documented formatRuns locally, version 1.0.22Config checkedVS Code docs
CodexClientInstall recipe matches the client's documented formatRuns locally, version 1.0.22Config checkedCodex docs

Stars and usage

How BurtTheCoder/mcp-shodan is growing

GitHub stars

178 to 188

stars. 26 Oct 2026 to 8 Nov 2026, 3 readings.

Source: GitHub. Checked .

Health and security

Is BurtTheCoder/mcp-shodan looked after, and what do its setup files show

Health score

47 out of 100

Does someone look after this repository? It does not say the code is good or safe. Worked out from GitHub signals checked . How it is worked out

PartPointsWhat we saw
Recent activity30 of 30Last push 3 days ago
Releases7.5 of 151 release in 90 days
Issue repliesNot countedThe latest check has no issue response reading (fewer than 3 measured issues, or issues switched off)
Maintainer0 of 15Owned by a single user
Official source0 of 20Community server

Security check static checks

97 out of 100

Reads what is published about the server: package advisories, licence, secrets in the documented setup and tool permissions. Nothing is installed or run, so this is not a security assessment. Checked by edna-static-v1. What it checks

Licence: MIT

  • Low The documented install uses fastmcp, whose published metadata points at github.com/punkpeye/fastmcp, not this repository. Check it is the right package before installing.
  • Note No published npm or PyPI package of this repository was found, so package advisories were not checked.
  • Note Asks for SHODAN_API_KEY through environment variables.
  • Note The lab has not recorded this server's tool list yet, so tool permissions were not checked.
Tool permissions (1)
  • SHODAN_API_KEY, environment variable it asks for (a secret)

Sources

Where this comes from

  • GitHubRegistry

    Checked · Days since the last commit, GitHub forks, GitHub stars, Open issues, Releases in the last 90 days

A source shows what was published when we checked it. It does not certify security, performance or a working installation. Read our method.

Changelog

What changed

No changes recorded yet. Releases, price changes and deprecations appear here, with their dates, once we track them for this record.

Free 27-page guide

Get the free Developer’s Field Guide

A 27-page field guide to the AI coding workflow with Claude. Claude Code, MCP servers, the prompt patterns that work, and what to delegate. Free.

Enter your work email. We send it straight over, plus a few short notes worth knowing. Unsubscribe any time.

No spam. Unsubscribe any time.