Attack Surface MCP Server
Passive external attack-surface mapping: CT subdomains, DNS, TLS, HTTP posture…
- Pricing
- Open source
- Runs
- Locally or Remotely
- Version
- 0.6.0
- Listing updated
- 4 days ago
About Attack Surface MCP Server
Attack Surface MCP Server is an open-source MCP server. It can run locally on your machine or as a hosted remote server.
Passive external attack-surface mapping: CT subdomains, DNS, TLS, HTTP posture, RDAP/WHOIS, Shodan.
Install
Run in a terminal
claude mcp add attack-surface-mcp-server --env SHODAN_API_KEY='<SHODAN_API_KEY>' --env CERTSPOTTER_API_KEY='<CERTSPOTTER_API_KEY>' -- npx -y @cyanheads/attack-surface-mcp-serverAdd to claude_desktop_config.json
{
"mcpServers": {
"attack-surface-mcp-server": {
"command": "npx",
"args": [
"-y",
"@cyanheads/attack-surface-mcp-server"
],
"env": {
"SHODAN_API_KEY": "<SHODAN_API_KEY>",
"CERTSPOTTER_API_KEY": "<CERTSPOTTER_API_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"attack-surface-mcp-server": {
"command": "npx",
"args": [
"-y",
"@cyanheads/attack-surface-mcp-server"
],
"env": {
"SHODAN_API_KEY": "<SHODAN_API_KEY>",
"CERTSPOTTER_API_KEY": "<CERTSPOTTER_API_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"attack-surface-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@cyanheads/attack-surface-mcp-server"
],
"env": {
"SHODAN_API_KEY": "<SHODAN_API_KEY>",
"CERTSPOTTER_API_KEY": "<CERTSPOTTER_API_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"attack-surface-mcp-server": {
"command": "npx",
"args": [
"-y",
"@cyanheads/attack-surface-mcp-server"
],
"env": {
"SHODAN_API_KEY": "<SHODAN_API_KEY>",
"CERTSPOTTER_API_KEY": "<CERTSPOTTER_API_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"attack-surface-mcp-server": {
"command": "npx",
"args": [
"-y",
"@cyanheads/attack-surface-mcp-server"
],
"env": {
"SHODAN_API_KEY": "<SHODAN_API_KEY>",
"CERTSPOTTER_API_KEY": "<CERTSPOTTER_API_KEY>"
}
}
}
}Configuration
SHODAN_API_KEYOptional Shodan API key. Enables attacksurface_lookup_host; absent → that one tool returns source_unavailable and the rest of the server works.CERTSPOTTER_API_KEYOptional Certspotter API key. Raises CT-fallback rate limits; absent → free unauthenticated tier.ATTACKSURFACE_DEFAULT_RESOLVERSComma-separated public DNS resolver IPs. The first also supplies discovery liveness, PTR and public DNS checks before guarded connections.ATTACKSURFACE_HTTP_USER_AGENTDefault User-Agent for attacksurface_probe_http (overridable per call).ATTACKSURFACE_MAX_SUBDOMAINSMap/snapshot resolution cap; enumeration also caps each page at 50 candidates.ATTACKSURFACE_RDAP_BOOTSTRAP_URLRDAP bootstrap base URL; override for a private/mirrored RDAP.ATTACKSURFACE_ALLOW_PRIVATE_TARGETSSet true to permit non-public target ranges for trusted internal-network assessment; URL and HTTP(S) scheme checks remain enforced.MCP_LOG_LEVELSets the minimum log level for output (e.g., 'debug', 'info', 'warn').MCP_TRANSPORT_TYPESelects the HTTP transport.MCP_HTTP_HOSTThe hostname for the HTTP server.MCP_HTTP_PORTThe port to run the HTTP server on.MCP_HTTP_ENDPOINT_PATHThe endpoint path for the MCP server.MCP_AUTH_MODEAuthentication mode to use: 'none', 'jwt', or 'oauth'.MCP_LOG_LEVELSets the minimum log level for output (e.g., 'debug', 'info', 'warn').
Pricing
Open source
Attack Surface MCP Server FAQ
Is Attack Surface MCP Server free?
Yes. Attack Surface MCP Server is open source, so you can use and self-host it for free.
How do I add Attack Surface MCP Server to Claude Code?
Run this command in your terminal: claude mcp add attack-surface-mcp-server --env SHODAN_API_KEY='<SHODAN_API_KEY>' --env CERTSPOTTER_API_KEY='<CERTSPOTTER_API_KEY>' -- npx -y @cyanheads/attack-surface-mcp-server