Set up Shodan MCP in Claude Code
Internet-connected device search, IP reconnaissance, CVE lookups, and DNS intelligence via the Shodan API.
1
Locate the config file
Claude Code reads MCP server configuration from the following file:
~/.claude.jsonCreate this file if it does not already exist.
2
Add the configuration
You can configure Shodan MCP using the CLI command or by editing the config file directly.
Option A: CLI command
bash
claude mcp add shodan-mcp -e SHODAN_API_KEY=YOUR_SHODAN_API_KEY -- npx -y @burtthecoder/mcp-shodanOption B: Config file
json
{
"mcpServers": {
"shodan-mcp": {
"command": "npx",
"args": [
"-y",
"@burtthecoder/mcp-shodan"
],
"env": {
"SHODAN_API_KEY": "YOUR_SHODAN_API_KEY"
}
}
}
}3
Set up environment variables
Shodan MCP requires the following environment variables:
SHODAN_API_KEYRequiredShodan API key
4
Verify it works
Restart Claude Code. Shodan MCP should appear in your MCP server list with 7 tools available.
This server adds approximately 3,500 tokens to your context window for tool definitions.