# Parse-DMARC MCP Server

Gives an AI assistant access to DMARC aggregate reports that Parse DMARC pulls from your mailbox over IMAP and stores in SQLite. Useful for asking who sends mail as your domain.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 234 repo stars
- Author: dmarcguardhq
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/dmarcguardhq/parse-dmarc
- Updated: 2026-10-23
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/parse-dmarc-mcp-server

## What it does

This MCP server lets an AI assistant query the DMARC aggregate reports that Parse DMARC collects. The app reads reports over IMAP or from a local Maildir, unpacks gzip, zip and plain XML (16 MB limit per report after decompression), and writes them to a single SQLite file. No database server is involved.

The same binary also serves a web dashboard and a `_dmarc` record generator, and exposes 28 Prometheus metrics with a Grafana dashboard. You can ask the agent about report data and leave the dashboard closed.

The install command starts a container through `docker`, so Docker has to be on the machine. Reports only arrive when your `_dmarc` DNS record has an `rua=` address pointing at a mailbox that accepts mail. Gmail needs an App Password, not the account password. Only aggregate (RUA) reports are read; RUF failure reports, TLS-RPT and alerting are not built.

## Requirements
- Needs: Docker

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add parse-dmarc-mcp-server -- docker run -i --rm ghcr.io/meysam81/parse-dmarc:v1.4.7
```

### Codex

**Platform CLI**
```bash
codex mcp add parse-dmarc-mcp-server -- docker run -i --rm ghcr.io/meysam81/parse-dmarc:v1.4.7
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "parse-dmarc-mcp-server": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "ghcr.io/meysam81/parse-dmarc:v1.4.7"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "parse-dmarc-mcp-server": {
            "type": "stdio",
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "ghcr.io/meysam81/parse-dmarc:v1.4.7"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add parse-dmarc-mcp-server docker run -i --rm ghcr.io/meysam81/parse-dmarc:v1.4.7
```

## When to use it
- see which IPs send mail as your domain
- check whether SPF and DKIM pass for legitimate senders before moving from `p=none` to `p=reject`
- skip unpacking gzip and zip XML attachments by hand
- read reports from a Maildir on the same host as your mail server
- ask an agent about report data instead of searching the dashboard

## Example prompts
- Ask `parse-dmarc-mcp-server` which IP addresses sent mail as my domain
- Use the `parse-dmarc-mcp-server` MCP server to show which senders fail SPF or DKIM
- With `parse-dmarc-mcp-server`, tell me whether I can move my policy from `p=none` to `p=quarantine`

## Similar
- [Email Deliverability Audit — SPF/DKIM/DMARC Check](https://affpapa.org/en/nevibecode/mcp/email-deliverability-audit-spfdkimdmarc-check.md) — MCP server · 3838 installs
- [mailx-tools](https://affpapa.org/en/nevibecode/mcp/mailx-tools.md) — MCP server · 1340 installs
- [DMARKOFF — DMARC, SPF & DKIM Analytics](https://affpapa.org/en/nevibecode/mcp/dmarkoff-dmarc-spf-dkim-analytics.md) — MCP server · ★ 8 repo stars
- [dns-doctor](https://affpapa.org/en/nevibecode/mcp/dns-doctor.md) — MCP server · ★ 3 repo stars
- [email-quality-auditor](https://affpapa.org/en/nevibecode/skills/email-quality-auditor.md) — skill · 1100 installs
- [email-deliverability](https://affpapa.org/en/nevibecode/skills/email-deliverability.md) — skill · 372 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
