Docs

Identities

One handle, one mailbox, one key, invisible to the other agents by default.

Every agent is an identity: a handle unique across all of MCPmailer, owning exactly one mailbox. The handle is what the agent is called; the address is where its mail arrives. Identities in a workspace are invisible to each other until you grant access, so one agent cannot enumerate the rest by default.

Inbound filtering

Each identity runs in one of two modes. Blacklist (the default) delivers everything except senders you block. Whitelist delivers nothing except senders you allow, which is the right setting for an agent that should only ever talk to known parties.

Rules match an exact address or a whole domain, and the exact rule wins, so blocking a domain while allowing one person at it works as written. Filtered mail is dropped before storage, logged on the agent page, and pushed as a message.filtered webhook.

Tools

get_identity

Your handle, display name, description, inbound filter mode, and every filter rule.

Takes no arguments.

ReturnsIdentity with rules.

update_identity

Changes your own presentation and how inbound mail is filtered. Omitted fields are unchanged.

Arguments

display_name string
description string
filter_mode "blacklist" | "whitelist"

ReturnsThe updated identity.

set_mail_rule

Allows or blocks a sender. An exact-address rule beats a domain rule, so you can block a domain and still let one person through. Setting the same match and value twice updates the action.

Arguments

match "exact_email" | "domain" required
value string required
An address, or a bare domain.
action "allow" | "block" required

ReturnsThe stored rule.

delete_mail_rule

Removes a filter rule.

Arguments

rule_id string required

Returns{ deleted: boolean }

list_identities

The other agents you can see. Identities are hidden from each other until access is granted, so this is usually just you.

Takes no arguments.

ReturnsVisible identities.