io.github.cyanheads/attack-surface-mcp-server MCP Server
io.github.cyanheads/attack-surface-mcp-server
What this kind of tool is for
- Scan a repository or dependency tree for known vulnerabilities.
- Audit secrets, permissions, or headers during a pre-release review.
- Have your agent explain a suspicious script or config before you run it.
How to compare servers like this
- Failure mode:
- Vulnerability reports are probabilistic; read findings as leads to verify, not verdicts.
- Data leaving the box:
- Check whether files or code are uploaded anywhere before scanning anything private.
- Maintenance signal:
- Security rulesets age fast; stale tools miss new classes of issue.
- Report clarity:
- The best tools say what is wrong, how sure they are, and how to fix it — verify findings yourself.
This page carries your copy-paste config: pick your MCP client in the install section on this page and use the copy button.
What is the io.github.cyanheads/attack-surface-mcp-server MCP server?
Passive external attack-surface mapping: CT subdomains, DNS, TLS, HTTP posture, RDAP/WHOIS, Shodan.
How to install io.github.cyanheads/attack-surface-mcp-server
Copy-paste configuration for popular MCP clients.
SHODAN_API_KEYsecretOptional Shodan API key. Enables attacksurface_lookup_host; absent → that one tool returns source_unavailable and the rest of the server works.
CERTSPOTTER_API_KEYsecretOptional Certspotter API key. Raises CT-fallback rate limits; absent → free unauthenticated tier.
ATTACKSURFACE_DEFAULT_RESOLVERSComma-separated default DNS resolver IPs for attacksurface_resolve_dns.
ATTACKSURFACE_HTTP_USER_AGENTDefault User-Agent for attacksurface_probe_http (overridable per call).
ATTACKSURFACE_MAX_SUBDOMAINSCap on subdomains resolved during a map_domain run.
ATTACKSURFACE_RDAP_BOOTSTRAP_URLRDAP bootstrap base URL; override for a private/mirrored RDAP.
ATTACKSURFACE_ALLOW_PRIVATE_TARGETSSet true to disable the SSRF guard for internal-network assessment (local/trusted deployments only).
MCP_LOG_LEVELSets the minimum log level for output (e.g., 'debug', 'info', 'warn').
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'.
{
"mcpServers": {
"attack-surface-mcp-server": {
"command": "bun",
"args": [
"-y",
"@cyanheads/attack-surface-mcp-server",
"run",
"start:stdio"
],
"env": {
"SHODAN_API_KEY": "<YOUR_SHODAN_API_KEY>",
"CERTSPOTTER_API_KEY": "<YOUR_CERTSPOTTER_API_KEY>",
"ATTACKSURFACE_DEFAULT_RESOLVERS": "<YOUR_ATTACKSURFACE_DEFAULT_RESOLVERS>",
"ATTACKSURFACE_HTTP_USER_AGENT": "<YOUR_ATTACKSURFACE_HTTP_USER_AGENT>",
"ATTACKSURFACE_MAX_SUBDOMAINS": "<YOUR_ATTACKSURFACE_MAX_SUBDOMAINS>",
"ATTACKSURFACE_RDAP_BOOTSTRAP_URL": "<YOUR_ATTACKSURFACE_RDAP_BOOTSTRAP_URL>",
"ATTACKSURFACE_ALLOW_PRIVATE_TARGETS": "<YOUR_ATTACKSURFACE_ALLOW_PRIVATE_TARGETS>",
"MCP_LOG_LEVEL": "<YOUR_MCP_LOG_LEVEL>",
"MCP_HTTP_HOST": "<YOUR_MCP_HTTP_HOST>",
"MCP_HTTP_PORT": "<YOUR_MCP_HTTP_PORT>",
"MCP_HTTP_ENDPOINT_PATH": "<YOUR_MCP_HTTP_ENDPOINT_PATH>",
"MCP_AUTH_MODE": "<YOUR_MCP_AUTH_MODE>"
}
}
}
}Related MCP servers
Fetch METARs, TAFs, PIREPs, and domestic SIGMETs from the NWS Aviation Weather Center.
Search and retrieve bioRxiv and medRxiv preprints — by DOI, date interval, or keyword — via MCP.
Fetch US Bureau of Labor Statistics data — CPI, unemployment, wages, JOLTS, and more via MCP.
Search posts, profiles, feeds, threads, and trending topics on Bluesky.
Collaborative BrAPI v2.1 MCP workspace — studies, germplasm, genotypes across Breedbase, T3, more.
Browser compatibility and Baseline status for any web feature — offline, from bundled MDN data.
