home / mcp / parse dmarc mcp server

Parse DMARC MCP Server

Fetches DMARC aggregate reports via IMAP, parses them, and exposes a dashboard with domain activity, sources, and authentication results.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "meysam81-parse-dmarc": {
      "url": "http://localhost:8080"
    }
  }
}

Parse DMARC monitors who is sending email on behalf of your domain by fetching DMARC aggregate reports from your inbox, parsing them, and presenting actionable insights in a compact dashboard. It helps you catch spoofing, identify legitimate sending sources, and guide enforcement decisions with a lightweight footprint.

How to use

You run Parse DMARC as a server, then connect to its dashboard from your browser. The server fetches DMARC reports via IMAP, processes them, stores results, and exposes a dashboard with statistics, top sending sources, and per-source authentication results. Use the dashboard to verify legitimate services, detect unauthorized use of your domain, and iteratively move from monitoring to enforcement.

How to install

Prerequisites you need before installation:

Docker installed on your machine or host
A domain you control for DMARC setup (for testing, you can use a test domain)
Access to an IMAP mailbox to receive DMARC reports (e.g., a dedicated Gmail/Outlook inbox)

Follow this concrete path to get started with Docker:

# 1) Pull the Parse DMARC image
docker pull meysam81/parse-dmarc:v1

# 2) Create a configuration directory and a sample config file
mkdir -p data
cat > config.json <<EOF
{
  "imap": {
    "host": "imap.gmail.com",
    "port": 993,
    "username": "[email protected]",
    "password": "your-app-password",
    "mailbox": "INBOX",
    "use_tls": true
  },
  "database": {
    "path": "/data/db.sqlite"
  },
  "server": {
    "port": 8080,
    "host": "0.0.0.0"
  }
}
EOF

# 3) Run Parse DMARC in detached mode, exposing the dashboard on port 8080
docker run -d \
  --name parse-dmarc \
  -p 8080:8080 \
  -v $(pwd)/config.json:/app/config.json \
  -v parse-dmarc-data:/data \
  meysam81/parse-dmarc:v1

# 4) Access the dashboard in your browser
# http://localhost:8080

Notes and tips for a smooth setup: - Ensure the IMAP credentials in config.json are correct and that the mailbox can receive DMARC reports. - If you use Gmail, an App Password is typically required instead of your regular password. - The DataDir volume stores the SQLite database; you can map it to a persistent path on your host. - If you need to stop the server, use: docker stop parse-dmarc and docker rm parse-dmarc.

Available tools

Auto-fetch from IMAP

Automatically connects to your IMAP inbox, fetches DMARC aggregate reports, and processes them into structured data.

Dashboard analytics

Provides real-time statistics, top sending sources, and authentication results to help you monitor and secure your domain.

DNS helper

Includes a built-in DNS record generator to help you configure DMARC, SPF, and DKIM for your domain.

Single-binary deployment

Runs as a compact 14MB image with no additional databases or complex setup.

TLS support

Supports secure TLS connections to email providers and dashboard access.