Juniper Coffee <hello@news.junipercoffee.com>
20% off your next bag, this weekend only
- SPF, DKIM, and DMARC pass
- Valid
List-Idheader (weekly.junipercoffee.com) - DKIM-signed RFC 8058 one-click unsubscribe
unsubscribeunsubscribed
Half the “unsubscribe” links in your inbox belong to real newsletters you forgot signing up for. The other
half are traps that confirm your address is active. Give a dedicated cleanup agent its own Gmail label—co:unsubscribe-agent—and
let it inspect the headers first: legitimate lists get a signed one-click unsubscribe, and shady senders go
straight to spam without anyone opening a link.
Takes a minute to apply. No credit card required.
unsubscribe-agent2 threads labeled co:unsubscribe-agent
Juniper Coffee <hello@news.junipercoffee.com>
20% off your next bag, this weekend only
List-Id header (weekly.junipercoffee.com)unsubscribeunsubscribed
Rewards Center <claim@rewards-center-4471.top>
Final notice: claim your $500 gift card
List-Id · footer link points to an unrelated domainmark_thread_spammoved to spam
co:unsubscribe-agent. The agent unsubscribes from the verified list and reports the spoofed sender as spam—without opening a browser on either link.The problem
When you want off a real mailing list, unsubscribing works. When the email is cold spam or phishing, clicking the footer link just confirms that a real person reads this address.
Unsubscribe links carry a unique identifier tied to your email address. Following one on a spam message tells the sender that an active human opened the email—making your address worth sending more to.
Clicking an unsubscribe link in your browser—or letting a browser-automation bot click it for you—loads whatever page the sender hosts, logs your IP and browser fingerprint, and often asks you to “confirm” your identity.
Before you ever touch a link, Gmail’s SPF, DKIM, and DMARC verdicts, the List-Id header, and the List-Unsubscribe domain reveal whether you’re dealing with a reputable bulk sender or a throwaway domain. Checking raw headers is tedious for you and instant for an agent.
How it works
Create an agent named unsubscribe-agent in comail. Connect Claude, ChatGPT, or your own MCP client to its URL and give it a straightforward prompt: unsubscribe from legitimate mailing lists, and mark anything suspicious as spam.
Apply co:unsubscribe-agent to newsletters, promotions, or junk mail in Gmail on your laptop or phone. You can select dozens of threads at once and label the whole batch in one go.
A notification wakes the agent up. Calling get_message returns the sender, the List-Id and List-Unsubscribe headers, and Gmail’s own SPF, DKIM, and DMARC verification results alongside the message text.
For a verified list, the agent calls unsubscribe and comail dispatches the RFC 8058 one-click request. For anything unsigned or sketchy, the agent calls mark_thread_spam and nothing is ever sent to the sender.
> Watch co:unsubscribe-agent. Unsubscribe from legitimate mailing lists and move anything sketchy to spam.
comail · create_notification_url
Listening for new mail · renews hourly
notification message: msg_2b81f0
comail · get_message (message_id: "msg_2b81f0")
From: Juniper Coffee <hello@news.junipercoffee.com>
List-Id: weekly.junipercoffee.com · dkim: pass · dmarc: pass
Authenticated retail newsletter with a signed one-click header. Unsubscribing.
comail · unsubscribe (message_id: "msg_2b81f0")
status: "unsubscribed"
notification message: msg_2b8a17
comail · get_message (message_id: "msg_2b8a17")
From: Rewards Center <claim@rewards-center-4471.top>
no List-Id · dkim: none · dmarc: fail
Unsigned sender failing DMARC with an off-domain opt-out link. Moving to Spam without clicking.
comail · mark_thread_spam (thread_id: "thr_2b8a17")
changed: ["msg_2b8a17"]
Guardrails
The agent never visits URLs from an email body. It passes a message ID to comail’s unsubscribe tool, which runs strict cryptographic and network checks before making a request.
comail only sends an unsubscribe request when the message has a single https List-Unsubscribe URL and List-Unsubscribe-Post: List-Unsubscribe=One-Click, with both headers covered by a DKIM signature verified by Gmail. Otherwise unsubscribe returns not_one_click and sends nothing.
comail sends a single POST request to a public IP address and refuses to follow HTTP redirects. No webpage is loaded or rendered, so neither your browser nor your IP address ever reaches the sender’s server.
Spam is untrusted input. Because this agent only sees threads you explicitly labeled for it—and has sending, trashing, and attachment reading turned off—a malicious email can’t trick it into reading your private mail, opening a file, or sending a reply.
Permissions
New agents in comail start in allow-list mode with sending and trashing off. Disable attachment access—from the dashboard or via the management MCP—and the agent has only the permissions needed to clean up unwanted mail.
Inbox hygiene
An allow-list agent that sees nothing unless you label it co:unsubscribe-agent. It can execute one-click unsubscribes, move threads to Spam, and archive—without access to attachments, sending, or Trash.
| view | allow | co:unsubscribe-agent |
| view | deny | default |
| spam | allow | report spam, unsubscribe |
| archive | allow | — |
| attachments | deny | filenames only |
| send | deny | drafts only |
| trash | deny | — |
> Create an unsubscribe-agent that only reads mail I label for it. Disable attachments and sending.
comail-admin · create_agent (name: "unsubscribe-agent")
Allow-list (co:unsubscribe-agent) · drafts only
comail-admin · set_agent_attachments (can_read_attachments: false)
ok
Ready: mcp.comail.io/a/3c9d02e1/unsubscribe-agent
spam and archive enabled. Turning off attachment contents is a single call.FAQ
Yes, which is why the agent inspects the sender first and only calls unsubscribe on legitimate mailing lists. Reputable bulk senders are required by Gmail’s sender guidelines to support and honor RFC 8058 one-click unsubscribes; sketchy or unauthenticated senders get moved straight to Spam without any network request.
unsubscribe returns not_one_click (along with the list’s mailto: unsubscribe address if one is present in the header) and sends nothing. Your agent can then either move future emails to Spam or prepare an unsubscribe draft in Gmail Drafts for you to send.
Yes. Search or filter in Gmail, select a batch of threads, and apply co:unsubscribe-agent in one action. comail queues a notification for each newly labeled thread so your agent works through the batch automatically. You can also use a Gmail filter to apply the label to incoming mail automatically.
No. mark_thread_spam moves the thread to Gmail’s Spam folder, where you (or the agent via unmark_thread_spam) can move it back to the inbox. The agent has no Trash permission, and comail has no permanent delete tool. One limit to know: Gmail deletes anything left in Spam after 30 days, so that’s the recovery window.
We’re onboarding beta users in small batches. Tell us what you want your agent to handle; specific use cases go to the front of the line.