Abnormal Security MCP
MCP server for Abnormal Security — AI-powered email threat detection, message analysis, abuse mailbox triage, and security case investigation.
🔗 Companion Plugin
Pair this MCP server with the Abnormal Security plugin for skills, commands, and API knowledge alongside direct API access.
Installation
Run the MCP server with npx:
npx @wyre-technology/abnormal-mcp Or install the package:
npm install @wyre-technology/abnormal-mcp MCPB Bundle (Claude Desktop)
Download the .mcpb bundle from
GitHub Releases
for a zero-config Claude Desktop install. No Node.js or terminal required — just open the
bundle in Claude Desktop via Settings → MCP Servers → Install from file.
Requires Claude Desktop 0.10+.
Claude Desktop Configuration
Add to your claude_desktop_config.json:
{
"mcpServers": {
"abnormal": {
"command": "npx",
"args": [
"@wyre-technology/abnormal-mcp"
],
"env": {
"ABNORMAL_API_TOKEN": "your-abnormal-api-token"
}
}
}
} Authentication
| Variable | Required | Description |
|---|---|---|
ABNORMAL_API_TOKEN | Yes | Abnormal Security API token (generate in the Abnormal portal under Settings → API) |
Architecture
Decision-tree MCP server — start with abnormal_navigate to select a domain, then call domain-specific tools.
Available Tools (8)
Tools are organized into 5 domains:
Threats
Detected threat cases with full details and AI analysis.
| Tool | Description |
|---|---|
abnormal_threats_list | List detected threat cases (paginated) |
abnormal_threats_get | Get full details of a specific threat by ID |
Messages
Per-threat message inspection: headers, URLs, attachments, AI analysis.
| Tool | Description |
|---|---|
abnormal_messages_list | List messages within a threat case |
abnormal_messages_get | Get detailed message analysis (headers, URLs, attachments, AI analysis) |
Remediation
Trigger or check remediation actions for messages.
| Tool | Description |
|---|---|
abnormal_remediation_manage | Trigger or check remediation actions for a message |
Abuse
User-reported phishing via the Abuse Mailbox.
| Tool | Description |
|---|---|
abnormal_abuse_list | List phishing emails reported via the Abuse Mailbox |
Cases
Active security investigation cases.
| Tool | Description |
|---|---|
abnormal_cases_list | List active security investigation cases |
abnormal_cases_get | Get details of a specific case |