Skip to main content
Glama
AttackScout MCP server

AttackScout MCP server

Official
by AttackScout
README.md
# AttackScout MCP server

A Model Context Protocol server exposing the AttackScout public audit as tools: grade A to F, SSL/TLS, DNS and registration, email authentication (SPF, DKIM, DMARC) and upcoming deadlines.

Part of [AttackScout](https://attackscout.com/en?utm_source=github&utm_medium=repo&utm_campaign=attackscout-mcp): what an attacker can see of your site from the Internet, explained simply, with the fix.

## Tools

| Tool | What it returns |
|---|---|
| `check_domain` | Overall grade, what to fix, deadlines |
| `check_ssl` | SSL/TLS and HTTPS findings |
| `check_dns` | DNS and registration findings |
| `check_email` | SPF, DMARC, DKIM and related findings |

Each tool takes one argument, `domain`.

## 1. Get a free API key

Create a key (free account, no card): [https://attackscout.com/espace/cles?utm_source=mcp&utm_medium=agent&utm_campaign=mcp-cle](https://attackscout.com/espace/cles?utm_source=mcp&utm_medium=agent&utm_campaign=mcp-cle). Channel `mcp`, scope `scans:write`. The key is read only from the `ATTACKSCOUT_API_KEY` environment variable; it is never logged or returned in an answer.

## 2. Configure your MCP client (stdio)

Requires Node.js 20 or later.

```json
{
  "mcpServers": {
    "attackscout": {
      "command": "npx",
      "args": ["-y", "@attackscout/mcp"],
      "env": { "ATTACKSCOUT_API_KEY": "as_live_..." }
    }
  }
}
```

HTTP (Streamable HTTP, bound to 127.0.0.1 by default): `npx -y @attackscout/mcp --http --port 3333`.

## Limits

Free account quotas, per API key: 600 requests per hour and 100 audit requests per day (300 per day across all the keys of an account). A result less than 24 hours old is served from cache and still counts. Over quota the API answers HTTP 429 with a `Retry-After` header.

## Privacy

No tracker, no telemetry, nothing stored on your machine. The only data sent is the domain name you ask about, with your API key, to `https://attackscout.com`.

## Development

```sh
npm ci
npm test
```

## License

MIT