Set up Shodan MCP in Windsurf
Internet-connected device search, IP reconnaissance, CVE lookups, and DNS intelligence via the Shodan API.
1
Locate the config file
Windsurf reads MCP server configuration from the following file:
~/.codeium/windsurf/mcp_config.jsonCreate this file if it does not already exist.
2
Add the configuration
Add the following to your Windsurf 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 Windsurf. 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.