Skip to main content
Connector guides

Connect PowerDMARC

PowerDMARC is a hosted email authentication platform: DMARC, SPF, DKIM, MTA-STS and BIMI reporting and hosted records, with a management console for MSSPs (managed service providers). StackJack…

Written By Christopher Scaminaci

Last updated 13 days ago

PowerDMARC is a hosted email authentication platform: DMARC, SPF, DKIM, MTA-STS and BIMI reporting and hosted records, with a management console for MSSPs (managed service providers). StackJack connects an AI assistant to its API.

Connecting PowerDMARC to StackJack gives your AI assistant a family of powerdmarc_ MCP tools. MCP (Model Context Protocol) tools are the standardized commands an AI assistant can call through StackJack. With them, your AI can:

  • Read DMARC results - aggregate reports by sender, host, organization and result, forensic (failure) reports, TLS-RPT reports and DKIM selector use
  • Check domain health - the security score, the DNS change timeline and record history, reputation monitoring, alerts and their configurations
  • Look things up - SPF, DKIM, DMARC, BIMI, MX, CNAME, PTR, TXT and MTA-STS records, WHOIS, forward-confirmed reverse DNS, IP geolocation, lookalike domains, and a full domain analysis (also as a PDF, on Pro plans)
  • Generate records - DMARC, SPF, DKIM and BIMI records
  • Manage domains and hosted records (on Pro plans) - add and remove domains, hosted SPF, DKIM, DMARC and MTA-STS records, alerts, domain groups, and account members
  • Run an MSSP (on Pro plans, with an MSSP portal) - customer accounts, admins, settings, resource groups and the same reports and records per customer

How StackJack authenticates to PowerDMARC

PowerDMARC uses an API token, sent as a bearer token. You create it, StackJack stores it encrypted and sends it only to the PowerDMARC address you connected.

Creating the token

  1. Sign in to PowerDMARC at app.powerdmarc.com (or your MSSP portal) as the user the token should act for.
  2. Open API Settings, then Manage Tokens, then Add Token.
  3. Copy the token it generates.

A token has the access of the user who creates it. For the MSSP tools, create it as an MSSP-level user.

MSSPs: the portal address

If you are an MSSP, also copy the address you sign in to, for example https://your-mssp.powerdmarc.com. Enter the host only. Everyone else leaves the address empty, and StackJack uses app.powerdmarc.com.

Connect it in StackJack

  1. Open Connectors, then PowerDMARC.
  2. Enter the token in API token. MSSPs also enter the MSSP portal address.
  3. Click Test connection. StackJack reads one list (the account count for an MSSP, the first page of domains otherwise). The read changes nothing.

Enter the token again whenever you save the connection, including when you only rename it.

What is worth knowing before you start

Two sets of tools on one token

The powerdmarc_mssp_ tools are the MSSP API: customer accounts, admins, MSSP settings and the same families per customer. They run against your MSSP portal, so they need the portal address and fail with a clear "not configured" message without it. The other tools are the End User API and run against the same address, which is app.powerdmarc.com when you stored none. Whether the End User API answers on an MSSP portal host is not stated in PowerDMARC's reference, so if End User tools fail on an MSSP connection, tell StackJack support.

Reads that are POST

About thirty reads are POST requests with a JSON body, because PowerDMARC takes their filters that way: report queries, alert log queries, lookups, generators and the domain analysis. They are Free reads and change nothing. Pass the body as JSON text in the bodyJson argument; each tool's description lists the fields.

Paging

Lists take page and perPage. Most accept up to 100 per page, and the MSSP account list accepts up to 50. Two routes spell it perpage on the wire, which StackJack handles. The alert configuration list takes a required paginationPage and paginationPerPage.

Changing things

Tools that change domains, hosted records, members, admins or accounts are on the Pro tier, are marked destructive and ask for approval before they run. Three things deserve care:

  • Hosted records go live. Editing a hosted DMARC, SPF, DKIM or MTA-STS record changes your published DNS policy. A 423 answer means the domain's DNS is not set up for the hosted service yet.
  • Creating a domain can count against your plan. Check the limits before a bulk create.
  • Gradient. The MSSP Gradient tools connect and synchronize billing data with Gradient. The sync is destructive for that reason.

Reports with message data

The two forensic report tools return the failed messages' details, the DKIM generator returns a new private key, and the MSSP two-factor toggle returns the new seed. StackJack never records those answers and never turns one into a download link. The domain analysis PDF tools return a temporary download link that works for 30 minutes.

When PowerDMARC refuses a call

  • The token is rejected: it is wrong, was deleted, or belongs to a user who no longer has access. Create a new token and paste it again.
  • The token may not use that route: a token has the access of its user. MSSP routes need an MSSP-level user.
  • A value is rejected (422): the answer lists each field that failed. Correct them and try again.
  • A conflict (409): the thing probably already exists, or is in a state that does not allow the change.
  • Locked (423): the domain's DNS does not match what the hosted record needs. Fix the DNS records as the PowerDMARC console shows them.
  • Rate limited: PowerDMARC allows 60 requests a minute per token. StackJack paces its calls and backs off when asked.

Plans and limits

Reads are available on the Free tier, except the domain analysis PDF tools, which are Pro. Changes are Pro. Business reaches the same tools as Pro and differs by monthly call quota.

See the generated PowerDMARC tool reference for the current inventory, plan assignment, input schemas and destructive-action labels.

PowerDMARC tools

powerdmarc_ · 136 tools · Free 83 · Pro 53

Account members

ToolWhat it does
powerdmarc_delete_account_member
Pro · Destructive
DESTRUCTIVE.
powerdmarc_list_account_members
Free · Read-only
This provides a paginated list of current account members.
powerdmarc_set_member_2fa_enforcement
Pro · Destructive
DESTRUCTIVE.
powerdmarc_update_account_member
Pro · Destructive
DESTRUCTIVE.

Alerts

ToolWhat it does
powerdmarc_create_dns_alert_configuration
Pro · Write
Creates a new DNS alert configuration.
powerdmarc_create_threshold_alert_configuration
Pro · Write
Creates a new Threshold alert configuration.
powerdmarc_delete_alert_configurations
Pro · Destructive
DESTRUCTIVE.
powerdmarc_get_alert_metrics
Free · Read-only
Get Alerts Metrics.
powerdmarc_list_alert_configurations
Free · Read-only
Returns a paginated list of all alert configurations (DNS and Threshold) for the current user.
powerdmarc_list_alert_logs
Free · Read-only
Retrieves a combined list of alert logs across all alert types (DNS and Threshold) in a lightweight format.
powerdmarc_list_alerts
Free · Read-only
Get Alerts.
powerdmarc_list_dns_alert_logs
Free · Read-only
Retrieves a list of DNS alert logs in a lightweight format.
powerdmarc_list_incident_alert_logs
Free · Read-only
Retrieves a paginated and filterable list of incidents by state, type, and date range.
powerdmarc_update_automatic_alert_configuration
Pro · Write
Edit Automatic Alerts Configuration.
powerdmarc_update_threshold_alert_configuration
Pro · Write
Updates an existing Threshold alert configuration.

Domains

ToolWhat it does
powerdmarc_bulk_create_domains
Pro · Destructive
DESTRUCTIVE.
powerdmarc_create_domain
Pro · Destructive
DESTRUCTIVE.
powerdmarc_delete_domain
Pro · Destructive
DESTRUCTIVE.
powerdmarc_delete_domain_group
Pro · Destructive
DESTRUCTIVE.
powerdmarc_get_bulk_dns_check
Free · Read-only
Returns details about a bulk domain processing job by its UUID.
powerdmarc_get_domain
Free · Read-only
Get an identified domain details.
powerdmarc_get_domain_group_reports
Free · Read-only
Get Domain Groups Reports.
powerdmarc_get_domain_health
Free · Read-only
Get Domain Health By Domain ID.
powerdmarc_list_domains
Free · Read-only
Get user domains details.
powerdmarc_start_bulk_dns_check
Free · Read-only
Create job to get domains DNS records.
powerdmarc_update_domain_group
Pro · Write
Edit Domains Group.

Hosted records

ToolWhat it does
powerdmarc_delete_hosted_dkim_selector
Pro · Destructive
DESTRUCTIVE.
powerdmarc_get_hosted_dmarc
Free · Read-only
Get Hosted DMARC By Domain ID.
powerdmarc_get_hosted_spf
Free · Read-only
Get HostedSpf by Domain ID.
powerdmarc_list_dkim_sending_services
Free · Read-only
Get DKIM Sending Services.
powerdmarc_update_hosted_dkim_selector
Pro · Destructive
DESTRUCTIVE.
powerdmarc_update_hosted_mta_sts_mode
Pro · Destructive
DESTRUCTIVE.
powerdmarc_update_hosted_mta_sts_policy
Pro · Destructive
DESTRUCTIVE.
powerdmarc_update_hosted_spf
Pro · Destructive
DESTRUCTIVE.

Reports

ToolWhat it does
powerdmarc_get_aggregate_detailed_stats
Free · Read-only
Get DMARC Aggregate report detailed stats.
powerdmarc_get_aggregate_hostname_details
Free · Read-only
Returns DMARC reports grouped by hostname.
powerdmarc_get_aggregate_per_host
Free · Read-only
Get DMARC Aggregate report per host.
powerdmarc_get_aggregate_per_organization
Free · Read-only
Get DMARC Aggregate report per organization.
powerdmarc_get_aggregate_per_result
Free · Read-only
Get DMARC Aggregate report per result.
powerdmarc_get_dkim_selector_utilization
Free · Read-only
Provides API access to detailed DKIM selector usage data across a domain, enabling automated monitoring, analysis, and optimization of email authentication configurations.
powerdmarc_get_forensic_data
Free · Read-only
Retrieve forensic report data.
powerdmarc_get_forensic_detail
Free · Read-only
Retrieve forensic report detail.
powerdmarc_get_tls_rpt_failure_details
Free · Read-only
Get TLS-RPT failure deatils by result ID.
powerdmarc_get_tls_rpt_per_result
Free · Read-only
Get TLS-RPT Per Result by Type.
powerdmarc_get_tls_rpt_per_result_details
Free · Read-only
Get TLS-RPT per result deatils by organization name.
powerdmarc_get_tls_rpt_sending_source_details
Free · Read-only
Get Sending Source Details.

DNS timeline and reputation

ToolWhat it does
powerdmarc_add_reputation_configuration_assets
Pro · Write
Add Reputation Monitoring Configuration Assets.
powerdmarc_create_reputation_configuration
Pro · Write
Create Reputation Monitoring Configuration.
powerdmarc_delete_reputation_alerts_history
Pro · Destructive
DESTRUCTIVE.
powerdmarc_get_dns_changes_timeline
Free · Read-only
Get DNS changes timeline.
powerdmarc_get_domain_records_history
Free · Read-only
Get domain records history.
powerdmarc_get_domain_security_score
Free · Read-only
Get current domain security score.
powerdmarc_get_reputation_asset_history
Free · Read-only
Get Reputation Monitoring Asset History.
powerdmarc_list_reputation_configurations
Free · Read-only
Get Reputation Monitoring Configurations.
powerdmarc_toggle_reputation_configuration
Pro · Write
Toggle Reputation Monitoring Configurations by config id.

Power tools

ToolWhat it does
powerdmarc_analyze_domain
Free · Read-only
Get a domain and return the results of the analysis.
powerdmarc_export_analysis_pdf
Pro · Read-only
Checks SPF, DKIM, DMARC, BIMI, MTA-STS and TLS-RPT records for a domain and returns the results as a PDF.
powerdmarc_generate_bimi_record
Free · Read-only
Generate BIMI record.
powerdmarc_generate_dkim_record
Free · Read-only
Generate DKIM record.
powerdmarc_generate_dmarc_record
Free · Read-only
Generate DMARC record.
powerdmarc_generate_spf_record
Free · Read-only
Generate SPF record.
powerdmarc_get_ip_geolocation
Free · Read-only
Get geolocation of an IP address.
powerdmarc_get_lookalike_analysis
Free · Read-only
Retrieve analyzed lookalike domains using job ID.
powerdmarc_lookup_bimi_record
Free · Read-only
DNS Lookup for BIMI record.
powerdmarc_lookup_cname_record
Free · Read-only
DNS Lookup for CNAME record.
powerdmarc_lookup_dkim_record
Free · Read-only
DNS Lookup for DKIM record.
powerdmarc_lookup_fcrdns
Free · Read-only
Lookup for FCRDNS.
powerdmarc_lookup_mta_sts_record
Free · Read-only
Lookup for MTA-STS TLS-RPT Record.
powerdmarc_lookup_mx_record
Free · Read-only
Lookup for MX record.
powerdmarc_lookup_ptr_record
Free · Read-only
Lookup for PTR record.
powerdmarc_lookup_spf_record
Free · Read-only
DNS Lookup for SPF record.
powerdmarc_lookup_txt_record
Free · Read-only
Lookup for TXT record.
powerdmarc_lookup_whois
Free · Read-only
Lookup for WHOIS record.
powerdmarc_start_lookalike_analysis
Free · Read-only
Initiates lookalike domain analysis for a given domain and returns a job ID.

MSSP administration

ToolWhat it does
powerdmarc_mssp_count_accounts
Free · Read-only
Get MSSP Account Counts.
powerdmarc_mssp_count_domains
Free · Read-only
Get MSSP Accounts Active Domain Count.
powerdmarc_mssp_create_admin
Pro · Destructive
DESTRUCTIVE.
powerdmarc_mssp_create_child_mssp
Pro · Destructive
DESTRUCTIVE.
powerdmarc_mssp_create_resource_group
Pro · Write
Create Resource Group.
powerdmarc_mssp_delete_account
Pro · Destructive
DESTRUCTIVE.
powerdmarc_mssp_delete_admin
Pro · Destructive
DESTRUCTIVE.
powerdmarc_mssp_delete_resource_group
Pro · Destructive
DESTRUCTIVE.
powerdmarc_mssp_get_account
Free · Read-only
Get MSSP Account data by account ID.
powerdmarc_mssp_get_admin
Free · Read-only
Get MSSP Admins By User Id.
powerdmarc_mssp_get_domain_group_reports
Free · Read-only
Get Domain Groups Reports.
powerdmarc_mssp_get_domain_health
Free · Read-only
Get Domain Health By Domain ID, the domain.
powerdmarc_mssp_get_settings
Free · Read-only
Get Mssp Settings.
powerdmarc_mssp_integrate_gradient
Pro · Destructive
DESTRUCTIVE.
powerdmarc_mssp_list_accounts
Free · Read-only
Get MSSP Accounts with additional data.
powerdmarc_mssp_list_accounts_domains
Free · Read-only
Get MSSP Accounts Domains data.
powerdmarc_mssp_list_admins
Free · Read-only
Get MSSP admins.
powerdmarc_mssp_list_email_notification_types
Free · Read-only
Get Email Notification Types.
powerdmarc_mssp_list_mssps
Free · Read-only
This gets a paginated list of all MSSPs.
powerdmarc_mssp_set_reputation_assets_limit
Pro · Destructive
DESTRUCTIVE.
powerdmarc_mssp_set_reputation_frequency
Pro · Destructive
DESTRUCTIVE.
powerdmarc_mssp_sync_gradient
Pro · Destructive
DESTRUCTIVE.
powerdmarc_mssp_toggle_mssp_status
Pro · Destructive
DESTRUCTIVE.
powerdmarc_mssp_toggle_two_factor
Pro · Destructive
DESTRUCTIVE.
powerdmarc_mssp_update_account
Pro · Destructive
DESTRUCTIVE.
powerdmarc_mssp_update_admin
Pro · Destructive
DESTRUCTIVE.
powerdmarc_mssp_update_mssp
Pro · Destructive
DESTRUCTIVE.
powerdmarc_mssp_update_settings
Pro · Write
Enable or disable MSSP Settings By Id.

MSSP domains and members

ToolWhat it does
powerdmarc_mssp_create_domain
Pro · Destructive
DESTRUCTIVE.
powerdmarc_mssp_get_account_domain
Free · Read-only
This gets a domain details which is under the specified account.
powerdmarc_mssp_get_account_domains_overview
Free · Read-only
Get account domains overview data.
powerdmarc_mssp_get_account_member
Free · Read-only
This gets a detailed information about a user under the specified account.
powerdmarc_mssp_get_domain_reports
Free · Read-only
Get Domains Reports.
powerdmarc_mssp_list_account_domains
Free · Read-only
This gets a pagiated list of account domains.
powerdmarc_mssp_list_account_members
Free · Read-only
This provides a paginated list of the specified account members.
powerdmarc_mssp_update_domain_group
Pro · Write
Edit Domains Group.

MSSP alerts

ToolWhat it does
powerdmarc_mssp_create_automatic_alert_configuration
Pro · Write
Create Automatic Alerts Configuration.
powerdmarc_mssp_create_threshold_alert_configuration
Pro · Write
Create Threshold Alerts Configuration.
powerdmarc_mssp_delete_user_alert_configurations
Pro · Destructive
DESTRUCTIVE.
powerdmarc_mssp_get_alert_metrics
Free · Read-only
Get Alerts Metrics.
powerdmarc_mssp_list_account_alerts
Free · Read-only
Get Account Alerts.
powerdmarc_mssp_list_user_alerts
Free · Read-only
Get Alerts.

MSSP DNS timeline

ToolWhat it does
powerdmarc_mssp_get_dns_changes_timeline
Free · Read-only
Get DNS changes timeline.
powerdmarc_mssp_get_domain_records_history
Free · Read-only
Get domain records history.

MSSP hosted records

ToolWhat it does
powerdmarc_mssp_create_hosted_dkim_selectors
Pro · Destructive
DESTRUCTIVE.
powerdmarc_mssp_delete_hosted_dkim_selector
Pro · Destructive
DESTRUCTIVE.
powerdmarc_mssp_get_hosted_dkim
Free · Read-only
Get Hosted DKIM By Domain ID.
powerdmarc_mssp_get_hosted_dmarc
Free · Read-only
Get Hosted DMARC By Domain ID.
powerdmarc_mssp_get_hosted_mta_sts_policy
Free · Read-only
Get HostedMtaSts Policy By Domain ID.
powerdmarc_mssp_get_hosted_spf
Free · Read-only
Get SPF by Domain ID.
powerdmarc_mssp_reset_hosted_mta_sts_policy
Pro · Destructive
DESTRUCTIVE.
powerdmarc_mssp_set_hosted_dmarc
Pro · Destructive
DESTRUCTIVE.
powerdmarc_mssp_update_hosted_dkim_selector
Pro · Destructive
DESTRUCTIVE.
powerdmarc_mssp_update_hosted_mta_sts_mode
Pro · Destructive
DESTRUCTIVE.
powerdmarc_mssp_update_hosted_mta_sts_policy
Pro · Destructive
DESTRUCTIVE.
powerdmarc_mssp_update_hosted_spf
Pro · Destructive
DESTRUCTIVE.

MSSP power tools

ToolWhat it does
powerdmarc_mssp_analyze_domain
Free · Read-only
Get a domain and return the results of the analysis.
powerdmarc_mssp_export_analysis_pdf
Pro · Read-only
Checks SPF, DKIM, DMARC, BIMI, MTA-STS and TLS-RPT records for a domain and returns the results as a PDF.
powerdmarc_mssp_generate_bimi_record
Free · Read-only
Generate BIMI record.
powerdmarc_mssp_get_lookalike_analysis
Free · Read-only
Retrieve analyzed lookalike domains using job ID.
powerdmarc_mssp_lookup_dmarc_record
Free · Read-only
Lookup for DMARC record.
powerdmarc_mssp_start_lookalike_analysis
Free · Read-only
Initiates lookalike domain analysis for a given domain and returns a job ID.