Campaign MCP and CLI Workflows
Let agents create campaigns, add selected prospects, inspect capacity, update sender limits, launch, and check status.
Agents can add selected prospects directly into a chosen campaign through MCP, CLI, or REST. There is no second approval UI in this phase. Sending still cannot bypass DeepSyte cron or server-side quota gates.
MCP tools
| Tool | Purpose |
|---|---|
create_audit_campaign | Create a campaign, optionally with initial targets. |
add_audit_campaign_targets | Add selected targets to an existing campaign. |
list_campaign_sender_capacity | Inspect AgentMail sender capacity and warmup/manual limits. |
update_campaign_sender_limits | Switch warmup/manual mode or update daily limits. |
launch_audit_campaign | Launch a campaign for cron processing. |
get_audit_campaign_status | Check campaign counts, statuses, blocked rows, and recipient report URLs. |
create_audit_report | Queue a hosted single-page or full-site report outside a campaign. |
get_audit_report_status | Check hosted report status, confidence, proof, run URL, and report URL. |
get_audit_report_link | Return the hosted report URL for a report job. |
create_audit_comparison_report | Create a hosted before/after comparison report. |
get_audit_comparison_report_link | Return a hosted comparison report URL. |
CLI commands
deepsyte campaigns create --name "Sydney plumbers" --send-at 2026-05-12T00:00:00.000Z --timezone Australia/Sydney --file targets.csv
deepsyte campaigns add-targets --campaign <id> --file targets.csv
deepsyte campaigns capacity
deepsyte campaigns sender-limits --account <id> --mode warmup --daily-limit 10
deepsyte campaigns sender-limits --domain <domainId> --mode manual --daily-limit 40
deepsyte campaigns launch <id>
deepsyte campaigns status <id>
deepsyte reports run https://example.com --type single-page --share
deepsyte reports run https://example.com --type full-site --share
deepsyte reports status <auditId>
deepsyte reports link <auditId>
deepsyte reports compare --before <beforeAuditId> --after <afterAuditId> --shareCodex pattern
- Research and select targets.
- Create or choose a campaign.
- Add targets through MCP or CLI.
- Check sender capacity.
- Launch the campaign when ready.
- Let cron enforce send windows, suppressions, report quality gates, and provider limits.
Use AgentMail for campaign sending and reply threads. Use Resend only for DeepSyte transactional/report delivery.
When a user asks for a hosted report link rather than a campaign, use the reports commands or report MCP tools. Hosted report responses always include the report URL, PDF action, evidence run URL, score, top finding, and confidence status.