MCP tools
A new MCP session presents a compact surface. Tool availability is filtered by the caller’s live mailbox grants and token scopes.
| Tool | Purpose |
|---|---|
get_identity |
Inspect the caller, mailboxes, permissions, and limits |
email_query |
Find and read messages |
email_act |
Act on messages, compose, reply, forward, or empty a folder |
email_await |
Wait for matching mail or approval state changes |
email_requests |
List, inspect, decide, or cancel approval requests |
settings_toggle_advanced_tools |
Show or hide granular tools for this session |
The four email_* names are API shapes, not grantable scopes. Each operation checks the granular
scope to which it resolves.
Advanced tools
Section titled “Advanced tools”Calling settings_toggle_advanced_tools with advanced tools enabled reveals only the granular
names the caller can use.
| Area | Tools |
|---|---|
| Identity and read | get_identity, read_inbox, monitor_inbox |
| Request an action | wants_to_move, wants_to_copy, wants_to_expunge, wants_to_send_draft |
| Direct filing | move, copy, trash, spam, archive |
| Drafts | start_draft, edit_draft, patch_draft, reply_to_thread, discard_draft, send_draft |
| Flags | set_flags |
| Approvals | approval_list, approval_status, monitor_approval, cancel_approval, approval_commit |
Advanced visibility does not alter authorization. A hidden granular tool remains callable by its exact name when the caller is authorized; the toggle changes discovery only.
Long-running email_await, monitor_inbox, and monitor_approval calls can be augmented with MCP
tasks when the negotiated protocol version supports them. Results put machine-readable data in
structuredContent; the default compatibility mode also duplicates JSON in text content.