MCP Tools Reference
17 tools available for managing agent email, webhooks, and trusted senders. All tools automatically use the agent associated with your API key.
get_agent_infoGet the current agent's name, email address, slug, description, and status.
read_inboxList emails in the agent's inbox with optional filters and pagination.
status(string | null)— Filter: received, read, sent, draft, archivedlimit(int)— Max results (1-100, default 20)offset(int)— Skip N emails (default 0)read_emailGet the full content of a specific email including headers, body (text and HTML), and attachment list.
email_id*(string)— UUID of the email to readsend_emailSend an email from the agent's email address with support for threading (replies) and file attachments.
to*(list[string])— Recipient email addressesbody_text*(string)— Plain text bodysubject(string | null)— Email subject linecc(list[string] | null)— CC recipientsbcc(list[string] | null)— BCC recipientsbody_html(string | null)— HTML body (optional)in_reply_to_email_id(string | null)— UUID of email being replied to (for threading)attachments(list[dict] | null)— File attachments: [{filename, data (base64), content_type?}]. Max 10, 10 MB total.get_threadGet all emails in a conversation thread, sorted chronologically.
thread_id*(string)— UUID of the threadlist_attachmentsList all attachments for a specific email with filenames, types, and sizes.
email_id*(string)— UUID of the emaildownload_attachmentGet a pre-signed URL to download an attachment. URL is valid for 15 minutes.
attachment_id*(string)— UUID of the attachmentmark_emailUpdate an email's status or starred flag.
email_id*(string)— UUID of the emailaction*(string)— One of: read, unread, starred, unstarred, archivedsearch_emailsSemantic search across emails and document attachments (PDF, DOCX, XLSX, PPTX, CSV, TXT) using natural language. Results include source_type (email_body or attachment) and attachment_id when matching attachment content.
query*(string)— Natural language search querylimit(int)— Max results (1-50, default 10)get_attachment_textGet the extracted text content of a document attachment. Returns full text from PDF, DOCX, XLSX, PPTX, CSV, and TXT files processed by the RAG pipeline. Useful for reading document content found via search_emails.
attachment_id*(string)— UUID of the attachmentlist_webhooksList all webhooks configured for the current agent, including URL, events, active status, and creation date.
create_webhookCreate a new webhook to receive HTTP notifications when emails arrive or are sent. Returns a signing secret (shown once) for HMAC-SHA256 verification.
url*(string)— Target URL to receive POST requestsevents*(list[string])— Events to subscribe to: email.received, email.sentdescription(string | null)— Optional label for the webhookdelete_webhookDelete a webhook by ID. Removes the webhook and all its delivery history.
webhook_id*(string)— UUID of the webhook to deletelist_webhook_deliveriesList recent delivery attempts for a webhook, showing event type, HTTP status, success/failure status, and timestamps.
webhook_id*(string)— UUID of the webhooklimit(int)— Max results (1-100, default 20)is_trusted_sender computed from this list.list_trusted_sendersList all trusted senders for the current agent. The agent owner is always the default trusted sender.
add_trusted_senderAdd an email address to the trusted senders list. Emails from this address will have is_trusted_sender=true.
email_address*(string)— Email address to trustname(string | null)— Optional display nameremove_trusted_senderRemove a trusted sender by ID. The default trusted sender (agent owner) cannot be removed.
sender_id*(string)— UUID of the trusted sender to remove