Submit a ticket My Tickets
Welcome
Login  Sign up

PowerDMARC MCP — Getting Started (End User)

Overview

PowerDMARC's MCP (Model Context Protocol) server lets you connect your PowerDMARC account to AI hosts such as Claude Desktop, Cursor, and Claude Code. Once connected, your AI assistant can access DMARC reports, DNS lookups, domain management tools, and more — directly from your AI environment, without switching between platforms.

Capability

Description

Query DMARC Data

Ask your AI assistant to retrieve aggregate or forensic reports, domain health summaries, and threat intelligence from your PowerDMARC account.

Domain Management

Perform domain-related actions and lookups through natural language prompts in your AI host.

DNS Lookups

Run DNS queries and timeline checks without leaving your AI environment.

Scoped Access

Token-based authentication keeps access tightly scoped to the permissions you define — nothing outside your configured token is exposed.

1. Create an API Token

Before connecting your AI host, you need to create an API token with MCP access enabled. This token authenticates your AI host and defines what data it can access.

  1. Navigate to API Settings from the left-hand sidebar.

  2. Click Add Token (or select an existing token to edit it).

  3. Enter a Name for the token — use something descriptive, such as Claude Desktop or MCP Token.

  1. Enable the MCP toggle. This activates MCP access for the token.

NOTE

The Read Only Token toggle is separate from the MCP toggle. You can combine both if you want to restrict the token to read-only operations.

  1. Under Permissions, select the data scopes your AI host should have access to:

Permission

What it allows

Customers

Access to customer account data

Domain Management

Add, update, and manage domains

DMARC Aggregate Report

Read aggregate (RUA) report data

DMARC Forensic Report

Read forensic (RUF) report data

PowerSPF

Access SPF configuration and flattening data

Threat Intelligence

Access threat intelligence insights

View Audit Logs

Read audit log entries

Manage Users (add, update and delete)

User management actions

Power Toolbox

Access Power Toolbox features

Reputation Monitoring

Access reputation monitoring data

Manage Users with SCIM

SCIM-based user provisioning access

DNS Timeline

Access DNS change timeline data

NOTE

Only enable the permissions your AI host needs. For read-only AI workflows, consider enabling read-focused permissions and leaving user management permissions unchecked.

  1. Click Save.

Your token is now ready to use with the MCP server.

2. Install the MCP Server

Once your token is created, navigate to MCP from the left-hand sidebar to access the installation page.

Select your token from the MCP Token dropdown. If you need to review or update your token settings, click Manage token to return to API Settings.

Under Select your AI host, choose the environment you want to connect:

AI Host

Type

Protocol

Claude Desktop

Desktop app

HTTP

Cursor

IDE

HTTP

Claude Code

CLI

HTTP

OpenAI

Desktop app

HTTP

After selecting your AI host, the page displays the platform-specific setup steps. Follow the instructions for your chosen host below.

2.1 Claude Desktop

Switch between macOSWindows, and Linux using the OS selector in the top-right of the setup panel.

  1. Open Claude Desktop and go to Settings.

  2. Navigate to Connectors.

  3. Click Add → Custom → Web.

  4. Paste the MCP Server URL displayed on the PowerDMARC MCP page.

  5. Save the configuration and restart Claude Desktop.

  6. Verify the MCP server is listed and shows as connected.

NOTE

Claude Desktop must be on the latest version with MCP support enabled. Older versions do not support HTTP-based MCP connections.

2.2 Cursor

  1. Open Cursor and navigate to Settings → MCP.

  2. Click Add MCP Server.

  3. Paste the MCP Server URL displayed on the PowerDMARC MCP page.

  4. Save and restart Cursor.

  5. Verify the PowerDMARC server appears in your active MCP connections.

2.3 Claude Code

  1. Open your terminal.

  2. Run the setup command shown on the PowerDMARC MCP page, which includes your MCP Server URL.

  3. Verify the connection by running a test prompt in Claude Code that references your PowerDMARC data.

3. Monitor Usage

The MCP page displays live usage counters at the top of the screen:

Counter

Description

Today calls

Number of MCP requests made today

This week

Total MCP requests for the current week

Use these counters to confirm that your AI host is successfully connecting and making calls to the PowerDMARC MCP server.

4. Access Control

The MCP feature is available to specific PowerDMARC account types. Access is controlled through API token permissions — the AI host can only access data covered by the permissions enabled on the token used to connect.

To revoke access at any time, navigate to API Settings, open the token, and either disable the MCP toggle or delete the token entirely.

For further assistance, visit support.powerdmarc.com or contact your PowerDMARC account manager.

P
PowerDMARC is the author of this solution article.

Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.