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 分