Skip to content

Add bounce, suppression, and stats management tools#22

Open
stucchi wants to merge 1 commit into
ActiveCampaign:mainfrom
stucchi:feat/bounce-suppression-stats-tools
Open

Add bounce, suppression, and stats management tools#22
stucchi wants to merge 1 commit into
ActiveCampaign:mainfrom
stucchi:feat/bounce-suppression-stats-tools

Conversation

@stucchi
Copy link
Copy Markdown

@stucchi stucchi commented Mar 9, 2026

Summary

  • 8 new tools for managing bounces, suppressions, and delivery statistics:
    • getBounces, getBounce, activateBounce — list, inspect, and reactivate bounced addresses
    • getSuppressions, createSuppressions, deleteSuppressions — manage suppressed addresses
    • getBounceStats, getSpamStats — daily bounce and spam complaint statistics
  • Added server.json and mcpName in package.json for MCP Registry publishing readiness
  • Updated README with full documentation for all new tools

Motivation

The current server only supports sending emails and listing templates. In practice, managing bounces and suppressions is essential — for example, reactivating recipients blocked due to temporary mail server issues, or reviewing spam complaints. These tools wrap the existing Postmark Bounce API, Suppressions API, and Stats API.

MCP Registry

A server.json file is included with namespace io.github.activecampaign/postmark, ready for publishing via mcp-publisher. See the MCP Registry Quickstart for details.

Test plan

  • Verify getBounces returns bounce list with filters (type, email, date range)
  • Verify getBounce returns detailed bounce info for a given ID
  • Verify activateBounce reactivates a blocked recipient
  • Verify getSuppressions lists suppressed addresses per stream
  • Verify createSuppressions suppresses given email addresses
  • Verify deleteSuppressions removes suppressions
  • Verify getBounceStats and getSpamStats return daily breakdowns
  • Verify existing tools (sendEmail, sendEmailWithTemplate, listTemplates, getDeliveryStats) are unaffected

Add 8 new tools for managing bounces, suppressions, and delivery statistics:
- getBounces, getBounce, activateBounce: list, inspect, and reactivate bounced addresses
- getSuppressions, createSuppressions, deleteSuppressions: manage suppressed addresses
- getBounceStats, getSpamStats: daily bounce and spam complaint statistics

Also adds server.json and mcpName for MCP Registry publishing readiness.
@dandigangi
Copy link
Copy Markdown
Contributor

Thanks for contributing! The team and myself are reviewing!

@jaballer jaballer removed their request for review April 29, 2026 22:28
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants