Ironscales

io.github.WYRE-AI由 GitHub 账号 WYRE-AI 发布v2.0.1更新于 Nov 21, 2026

MCP server for Ironscales phishing incident management — incidents, mailboxes, and reporting.

已验证STDIO仅桌面沟通与协作安全与监控

概览

AI 生成的概览

将 AI 助手接入 Ironscales 邮件安全平台,用于调查钓鱼事件、分类邮件、执行处置并查看安全统计。

可以做什么
  • 检查连接状态并列出可用工具
  • 列出并查看钓鱼事件,在 MCP Apps 宿主中显示交互式事件卡片
  • 调查并分类邮件
  • 管理邮件允许列表与阻止列表
  • 执行邮件处置与隔离
  • 查看企业安全统计与报告
适用场景
适合使用 Ironscales 的安全团队或 MSP,希望助手在对话中分诊钓鱼事件、查看事件详情,并执行处置或调整允许列表。
运行要求
以本地进程(npm 包或容器镜像)通过 stdio 运行,托管时也可作为 HTTP 服务。需要 Ironscales API 密钥(IRONSCALES_API_KEY)和企业/租户 ID(IRONSCALES_COMPANY_ID);AUTH_MODE 可切换为网关注入请求头。需要访问 Ironscales 的网络连接。
安装前请注意
IRONSCALES_API_KEY 中的 API 密钥属于机密,可访问你的 Ironscales 租户。处置、隔离及允许/阻止列表工具会改变邮件处理方式并影响真实用户,批准前请核对操作。网关模式下凭据来自注入的请求头而非本地变量。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Ironscales,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

Ironscales MCP Server

[License] [Node.js]

A Model Context Protocol (MCP) server for Ironscales email security. Enables AI assistants to investigate phishing incidents, manage email classification, execute remediations, and view security statistics.

This is a Model Context Protocol (MCP) server that connects Claude (or any MCP-compatible AI) to your Ironscales environment.

Part of the MSP Claude Plugins ecosystem — a growing suite of AI integrations for the MSP stack. Built by MSPs, for MSPs.

Interactive Incident Card (MCP Apps)

ironscales_incidents_get renders as an interactive card in MCP Apps hosts (Claude Desktop/web) showing the phishing incident's subject, status, severity, sender, affected recipients, and threat indicators; plain-JSON behavior is unchanged in other hosts. The card is read-only — remediation stays with the model-driven remediation tools. It is neutral by default and brandable via window.__BRAND__ injection or MCP_BRAND_* env vars (MCP_BRAND_NAME, MCP_BRAND_LOGO_URL, MCP_BRAND_PRIMARY_COLOR, MCP_BRAND_ACCENT_COLOR, MCP_BRAND_BG, MCP_BRAND_TEXT) — no rebuild needed.

Installation

bash
npm install @wyre-ai/ironscales-mcp

Configuration

Set the following environment variables:

VariableRequiredDescription
IRONSCALES_API_KEYYesYour Ironscales API key
IRONSCALES_COMPANY_IDYesYour Ironscales company ID
MCP_TRANSPORTNoTransport mode: stdio (default) or http

Usage

Running with Claude Desktop

Add to your Claude Desktop claude_desktop_config.json:

json
{  "mcpServers": {    "ironscales-mcp": {      "command": "npx",      "args": ["@wyre-ai/ironscales-mcp"],      "env": {        "IRONSCALES_API_KEY": "your-ironscales-api-key"        "IRONSCALES_COMPANY_ID": "your-ironscales-company-id"      }    }  }}

Running with Claude Code (CLI)

bash
claude mcp add ironscales-mcp \  -e IRONSCALES_API_KEY=your-value \  -e IRONSCALES_COMPANY_ID=your-value \  -- npx -y @wyre-ai/ironscales-mcp

Docker

bash
docker build -t ironscales-mcp .docker run \  -e IRONSCALES_API_KEY=your-value \  -e IRONSCALES_COMPANY_ID=your-value \  -p 8080:8080 ironscales-mcp

Available Tools

Every tool is listed and callable immediately; there is no domain to enter first. The groupings below are documentation only.

Upgrading? ironscales_navigate and ironscales_back are removed. Call the domain tools directly. ironscales_status still works and now lists the available tools.

Status

  • ironscales_status - Connection status and the available tools

Allowlist

  • ironscales_allowlist_manage - Manage email allowlists and blocklists

Email

  • ironscales_email_classify - Email investigation and classification

Incidents

  • ironscales_incidents_list - List phishing incidents
  • ironscales_incidents_get - Get a phishing incident

Remediation

  • ironscales_remediation_act - Execute email remediations and quarantine

Stats

  • ironscales_stats_company - Security statistics and reporting

Development

bash
# Clone the repositorygit clone https://github.com/WYRE-AI/ironscales-mcp.gitcd ironscales-mcp
# Install dependenciesnpm install
# Buildnpm run build
# Run testsnpm test

Contributing

Contributions are welcome! Please see CONTRIBUTING.md if present, or open an issue to discuss changes.

License

Licensed under the Apache License, Version 2.0. See LICENSE for details.

来源:README.md,提交 2b66db5

工具

0
SourceWeft 尚未在沙箱中启动过该软件包,因此其工具未知。

版本历史

4
  1. v2.0.1最新Nov 21, 2026
  2. v2.0.0Nov 20, 2026
  3. v1.2.3Oct 13, 2026
  4. v1.2.2Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分