Dmarc Examiner

io.github.dmarc-examiner由 GitHub 帳號 dmarc-examiner 發布v1.1.0更新於 Nov 2, 2026

Read your own DMARC aggregate and forensic reports: sources, alignment, alerts, CSV export.

已驗證Streamable HTTP可網頁執行溝通與協作安全與監控資料與分析

概覽

AI 產生的概覽

DMARC Examiner 官方 MCP 伺服器，讓助理查詢你的 DMARC 彙總與鑑識報告、網域、警示和 Webhook。

可以做什麼
  • 列出、檢視、新增、驗證和移除受監控網域，並檢查任意網域的公開 DMARC 記錄
  • 列出並讀取彙總（RUA）報告，查看依國家和 ASN 的統計，並匯出 CSV
  • 列出並讀取鑑識（RUF）報告、其統計以及近 7 天摘要
  • 列出並忽略安全警示
  • 列出、建立、更新、刪除和測試 HTTPS Webhook 端點
適用情境
適合已使用 DMARC Examiner 監控網域的使用者，希望在 AI 用戶端中直接詢問寄件來源、SPF/DKIM 對齊、警示或鑑識失敗情況，而不必開啟儀表板或手動解析 XML 報告。
執行需求
需要 DMARC Examiner 帳號（基本使用免費方案即可；鑑識報告和 Webhook 需 Pro 以上）。可連線 mcp.dmarc-examiner.com 遠端端點，或不支援遠端 HTTP 的用戶端以 npx 執行 npm 套件。首次呼叫資料類工具時需在瀏覽器完成 OAuth 授權；npx 套件會在本機儲存權杖。選用環境變數 DMARC_EXAMINER_MCP_URL 可覆寫端點。
安裝前請注意
此伺服器會變更資料：可新增、驗證和軟刪除網域，忽略警示，以及建立、更新、刪除和測試 Webhook，建議只授予所需的權限範圍。npx 套件會在本機憑證檔案中儲存 OAuth 權杖（含更新權杖）。鑑識報告包含原始失敗郵件信封，可能含敏感郵件中繼資料。部分工具會因方案限制回傳 402 或 403。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Dmarc Examiner，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.dmarc-examiner%2Fmcp/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "dmarc-examiner": {
      "type": "http",
      "url": "https://mcp.dmarc-examiner.com/mcp"
    }
  }
}

README

@dmarc-examiner/mcp

[MCP] [License: MIT] [Tools]

Official MCP (Model Context Protocol) server for DMARC Examiner. Query your DMARC monitoring data from AI assistants like Claude Desktop, Claude Code, and Cursor.

Why

DMARC aggregate reports arrive as compressed XML, one file per receiver per day. Reading them means either opening a dashboard or parsing XML by hand.

This server puts that data behind an MCP connection, so you can ask questions instead:

Which sending sources failed DMARC alignment last week?

Show me the domains where SPF passes but DKIM does not.

Export the report for example.com as CSV.

DMARC Examiner is a DMARC monitoring service with a free tier — you need an account to use this server, but not a paid one.

Quick Setup

Option 1: Remote URL (Recommended)

Most MCP clients support remote HTTP servers directly. Add this to your MCP configuration:

json
{  "mcpServers": {    "dmarc-examiner": {      "url": "https://mcp.dmarc-examiner.com/mcp"    }  }}

Option 2: npx (for clients without remote HTTP support)

json
{  "mcpServers": {    "dmarc-examiner": {      "command": "npx",      "args": ["-y", "@dmarc-examiner/mcp"]    }  }}

Configuration by Client

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

json
{  "mcpServers": {    "dmarc-examiner": {      "url": "https://mcp.dmarc-examiner.com/mcp"    }  }}

Claude Code

bash
claude mcp add dmarc-examiner --transport http https://mcp.dmarc-examiner.com/mcp

Cursor

Add to your Cursor MCP settings:

json
{  "mcpServers": {    "dmarc-examiner": {      "url": "https://mcp.dmarc-examiner.com/mcp"    }  }}

Authorization

Adding the server does not require authorizing. It starts immediately and answers initialize, tools/list and ping without credentials, so your client can list all 21 tools straight away.

A browser opens the first time you call a tool that touches your data. You'll need to:

  1. Log in to your DMARC Examiner account
  2. Select which organization to connect
  3. Approve the requested permissions (scopes)

The call you made is then replayed automatically, so it completes rather than failing.

With Option 1 the MCP client runs this flow itself. With Option 2 the package does it: it registers as an OAuth client, opens your browser, and stores the resulting tokens in ~/.dmarc-examiner/mcp-credentials.json with 0600 permissions. The refresh token is reused on later runs, so the browser step happens once.

Why it works this way. Authorizing on startup is the obvious design and it breaks every automated client: directory checks, scanners and CI have no browser to open, so the server appears to hang and the check times out. We wrote up the failure and the fix, with logs, in Your Remote MCP Server Will Fail Every Directory Check.

You can also drive it directly:

bash
npx -y @dmarc-examiner/mcp login    # authorize now, outside your MCP clientnpx -y @dmarc-examiner/mcp logout   # forget the stored credentials

Set DMARC_EXAMINER_MCP_URL to point the package at a different endpoint.

Available Tools

Domains

ToolDescriptionScope
list_domainsList all monitored domains in your organizationdomains:read
get_domainGet details of a specific domaindomains:read
check_dmarcInspect the public DMARC record at _dmarc.<domain>. Works on any domain, not only your owndomains:read
create_domainAdd a domain. Returns the reporting email and DMARC record to publish in DNSdomains:manage
verify_domainRe-check DNS to confirm the DMARC record carries your reporting addressdomains:manage
delete_domainRemove a domain from monitoring. Soft delete — historical reports remaindomains:manage

Aggregate reports (RUA)

ToolDescriptionScope
list_reportsList DMARC reports with filteringreports:read
get_reportGet a detailed report with recordsreports:read
get_report_statisticsReport statistics by country and ASNreports:read
export_report_csvExport a report as CSVreports:export

Forensic reports (RUF)

Requires the Pro plan or above; these return 403 otherwise.

ToolDescriptionScope
list_forensic_reportsList RUF reports with filtering and paginationforensic:read
get_forensic_reportFull detail of a forensic report, including the failed message envelopeforensic:read
get_forensic_reports_statisticsCounters by failure type, delivery result, source IP with geolocation, and domainforensic:read
get_forensic_reports_summaryForensic activity over the last 7 daysforensic:read

Alerts

ToolDescriptionScope
list_alertsList security alertsalerts:read
dismiss_alertDismiss an alertalerts:manage

Webhooks

Requires the Pro plan or above; these return 403 otherwise.

ToolDescriptionScope
list_webhooksList configured webhook endpointswebhooks:read
create_webhookCreate an endpoint. The URL must be HTTPSwebhooks:manage
update_webhookUpdate the URL, name or active state of an endpointwebhooks:manage
delete_webhookDelete an endpoint permanentlywebhooks:manage
test_webhookSend a webhook.test event and return the delivery statuswebhooks:manage

Scopes

ScopeDescription
domains:readView monitored domains
domains:manageAdd, verify and remove domains
reports:readView reports and statistics
reports:exportExport reports to CSV
forensic:readView forensic (RUF) reports
alerts:readView alerts
alerts:manageManage alerts (dismiss)
webhooks:readView webhook endpoints
webhooks:manageCreate, update, delete and test webhooks

Documentation

For detailed documentation, visit: https://dmarc-examiner.com/docs/settings/mcp-integration?utm_source=github&utm_medium=content&utm_campaign=mcp-repo

Support

License

MIT — see LICENSE.

來源：README.md，提交 6da6a70

工具

21

list_domains

List all monitored domains in your organization

輸入參數pageper_page

get_domain

Get details of a specific domain

輸入參數domain_id必填

check_dmarc

Inspect the public DMARC record at _dmarc.<domain>. The domain does not need to belong to your organization. Returns parsed policy and rua/ruf addresses.

輸入參數domain必填

create_domain

Add a new domain to the organization. Response includes the reporting_email and dmarc_record values to publish in DNS. May return 402 if the plan domain limit has been reached.

輸入參數name必填

verify_domain

Re-check a domain's DNS to confirm the DMARC record contains the organization's reporting email. Updates status to verified on success.

輸入參數domain_id必填

delete_domain

Remove a domain from monitoring. Soft-deletes; historical reports remain accessible.

輸入參數domain_id必填

list_reports

List DMARC reports for your organization

輸入參數pagedomaindate_toper_pagedate_from

get_report

Get details of a specific DMARC report

輸入參數report_id必填

get_report_statistics

Get statistics for a specific DMARC report

輸入參數report_id必填

export_report_csv

Export a DMARC report as CSV

輸入參數report_id必填

list_alerts

List alerts for your organization

輸入參數pagestatusper_page

dismiss_alert

Dismiss a specific alert

輸入參數alert_id必填

list_forensic_reports

List DMARC RUF (forensic) reports with optional filtering and pagination. Returns 403 if the plan does not include forensic reports (Pro plan and above).

輸入參數pagedate_toper_pagedate_fromdomain_id

get_forensic_report

Get the full detail of a forensic (RUF) report by UUID, including the raw failed message envelope.

輸入參數report_id必填

get_forensic_reports_statistics

Aggregated forensic-report counters grouped by auth failure type, delivery result, source IP (with geolocation) and reported domain.

無需輸入參數。

get_forensic_reports_summary

Summary of forensic activity in the last 7 days — useful for daily digest views.

無需輸入參數。

list_webhooks

List webhook endpoints configured for the organization. Returns 403 if the plan does not include advanced alerting (Pro and above).

無需輸入參數。

create_webhook

Create a new webhook endpoint. URL must start with https://. Returns 422 if the organization has reached its webhook limit.

輸入參數url必填name必填

update_webhook

Update a webhook. Any combination of url, name and is_active may be provided; URL must remain HTTPS.

輸入參數urlnameis_activewebhook_id必填

delete_webhook

Delete a webhook endpoint permanently.

輸入參數webhook_id必填

test_webhook

Send a synchronous webhook.test event to verify connectivity. Returns the delivery status. Test events do NOT update last_triggered_at, last_status or failure_count.

輸入參數webhook_id必填

版本歷史

1
  1. v1.1.0最新Sep 16, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分