Domains
Sending domains and their nightly DNS and blacklist report. 4 endpoints, each also a tool for your AI through MCP. Authentication and errors are on the overview.
List sending domains with their health
GET/api/v1/domains
Same checks and score as the public checker, re-run daily.
MCP tool list_domainsRead-only
Returns a list of
domainrequiredstringmailboxesrequirednumberreportrequiredobject | nullhistoryrequiredobject[]- Up to 30 earlier scores, oldest first
curl https://ballast.to/api/v1/domains \
-H "Authorization: Bearer $BALLAST_API_KEY"Re-check a sending domain now
POST/api/v1/domains/check
MCP tool check_workspace_domain
Parameters
domainrequiredstring
Returns
domainrequiredstringselectorrequiredstring | nullexistsrequiredbooleanscorerequiredintegergraderequired"A" | "B" | "C" | "D" | "F"verdictrequiredstringmxFamilyrequired"google" | "microsoft" | "other" | "none"mxLabelrequiredstringcheckedAtrequiredstringdurationMsrequirednumbercachedrequiredbooleanchecksrequiredobject[]
curl -X POST https://ballast.to/api/v1/domains/check \
-H "Authorization: Bearer $BALLAST_API_KEY" \
-H "Content-Type: application/json" \
-d '{"domain":"<domain>"}'Add a sending domain and check it
POST/api/v1/domains
For setting up DNS before any mailbox is connected. Runs the full check (MX, SPF, DKIM, DMARC, blacklists) and returns the report with a fix for each problem.
MCP tool add_domainOwners and admins
Parameters
domainrequiredstring
Returns the same fields as Re-check a sending domain now.
curl -X POST https://ballast.to/api/v1/domains \
-H "Authorization: Bearer $BALLAST_API_KEY" \
-H "Content-Type: application/json" \
-d '{"domain":"<domain>"}'Remove a domain no mailbox uses
DELETE/api/v1/domains/{domain}
MCP tool remove_domainOwners and adminsMCP asks to confirm
Parameters
domainrequiredpath · string
Returns
okrequiredtrue
curl -X DELETE https://ballast.to/api/v1/domains/<domain> \
-H "Authorization: Bearer $BALLAST_API_KEY"