# Escouade Mail: the documentation

> Escouade Mail gives AI agents their own mailboxes, with sending rules the server enforces. 114 pages in Markdown; the French version is at https://escouade.io/mail/docs/llms.txt.

## Getting started

- [Introduction](https://escouade.io/en/mail/docs/index.md): What Escouade Mail is, its objects (inbox, thread, message, draft, key, space), its two MCP addresses, the two ways to call it, and the map of this documentation: getting started, concepts, guides, tool reference.
- [Getting started](https://escouade.io/en/mail/docs/demarrer.md): From the MCP address to the first e-mail: connect the server, sign up with sign_up, verify with the 6-digit code, have a first e-mail written to you, then pay through a link and register your domain.
- [For agents](https://escouade.io/en/mail/docs/agents.md): The page to read on your own when you are an AI agent discovering Escouade Mail: the path from signing up to replying to a correspondent, payment through a link handed to your human, the rules to know, what needs a human, and every tool.
- [Give an AI agent an e-mail inbox](https://escouade.io/en/mail/docs/donner-une-boite-mail-a-un-agent.md): How to give an AI agent its own e-mail address with Escouade Mail: what it takes, the steps, what the agent does with its inbox next, what it costs, and the limits to know.
- [Service status](https://escouade.io/en/mail/docs/etat.md): What is in service in Escouade Mail, what changed at opening, what is still to come and what the service does not do: open sign-ups, plans and payment by link, connector for online assistants.

## Concepts

- [Inboxes](https://escouade.io/en/mail/docs/boites.md): An inbox is an e-mail address driven by an agent: the first inbox on the shared domain, what it does before and after payment, the gradual warm-up, the daily quota, and the tools inbox_status, list_inboxes, create_inbox, delete_inbox.
- [Calendar and contacts](https://escouade.io/en/mail/docs/agenda-et-contacts.md): An inbox's calendar and contacts on a phone (iPhone, Android) or a calendar app, with an app password: getting it, entering it, what it opens and what it does not, meeting requests, Escouade reading the inbox, and the tools create_app_password, list_app_passwords, revoke_app_password.
- [Messages](https://escouade.io/en/mail/docs/messages.md): Write a first message with send_email, follow its statuses, read its log with get_message, cancel it, retry without duplicates with an idempotency_key.
- [Threads](https://escouade.io/en/mail/docs/fils.md): A thread is the conversation between an inbox and a correspondent: statuses, how replies are received, and the tools list_threads, get_thread, reply_to_thread.
- [Receiving mail](https://escouade.io/en/mail/docs/recevoir.md): What happens when an Escouade Mail inbox receives an e-mail: which thread it is filed in, how an agent collects its mail in one call, the collection delay, and the frame that marks content written by a third party.
- [Drafts and approval](https://escouade.io/en/mail/docs/brouillons.md): A send can wait for human approval: when a message stays a draft, how the human approves it from their assistant, and the tools list_drafts, update_draft, approve_message.
- [Attachments and copies](https://escouade.io/en/mail/docs/pieces-jointes.md): Attach a file to a reply through an upload link, read an attachment received, copy someone in: what is allowed, in which conversations, and the tools attach_files, remove_attachment, get_attachment.
- [Keys and permissions](https://escouade.io/en/mail/docs/cles.md): The Escouade Mail API key: its shape, how an agent presents it after sign_up, what each permission opens, the access of the human who approves through the connector, where to keep the key, and what to do if it is lost.
- [Space settings](https://escouade.io/en/mail/docs/espace.md): What a space's human adjusts from their assistant: the sending window, spacing, the duplicate rule, mandatory approval, the postal address, and closing the space.
- [The workbench in the assistant](https://escouade.io/en/mail/docs/vues.md): A single Escouade Mail workbench in the conversation: the chat changes the page displayed, unsaved input stays protected and reads keep the access's permissions.
- [The activity log](https://escouade.io/en/mail/docs/main-courante.md): Who did what, and when, in a space: your agent, you from your assistant, or the service; by day or by object, the author of each message, the previous version and going back, and the tools list_events and workspace_snapshot.

## Campaigns

- [Campaigns](https://escouade.io/en/mail/docs/campagnes.md): A campaign sends a sequence of messages to an audience, from one inbox, within the space's sending window and quotas; review before starting, A/B testing, templates, performance, and the tools list_campaigns, save_campaign, preview_campaign, campaign_action.
- [Contacts and audiences](https://escouade.io/en/mail/docs/contacts.md): The space's directory (one record per address, its fields, its tags, its blocks) and audiences, the lists a campaign goes to; batch import, and the tools list_contacts, save_contact, import_contacts, list_audiences.

## Sending

- [Sending rules](https://escouade.io/en/mail/docs/regles-envoi.md): What the server applies to every send, threshold by threshold: gradual warm-up, daily quota, working hours, human approval, unsubscribe, circuit breaker, and what the plan opens.
- [Domains](https://escouade.io/en/mail/docs/domaines.md): The shared domain subagentmail.fr, from which an inbox replies, and registering your own domain, from which a first message leaves: the DNS records to publish, and the tools add_domain, verify_domain, list_domains, remove_domain.
- [Unsubscribes and blocks](https://escouade.io/en/mail/docs/desinscription.md): The one-click unsubscribe link, the STOP reply, a space's block list, and the tools add_suppression, remove_suppression, list_suppressions.
- [Limits and quotas](https://escouade.io/en/mail/docs/limites.md): Every Escouade Mail number on one page: plans, e-mails per day, sizes, request rate, code and payment link lifetimes, circuit breaker thresholds, retention periods, and what the server does when a limit is reached.

## Guides

- [Reply to a correspondent](https://escouade.io/en/mail/docs/guide-repondre.md): The complete path of an agent replying to an e-mail with Escouade Mail: collect threads in one call, read the reply, answer in the thread with reply_to_thread, and the cases where you should not reply.
- [Approve an agent's sends](https://escouade.io/en/mail/docs/guide-validation.md): The complete path of human approval in Escouade Mail: the agent leaves a draft, its human connects their assistant through the connector, reviews the draft, then approves, corrects or refuses it.
- [Receive a verification code](https://escouade.io/en/mail/docs/guide-code.md): How an AI agent receives in its Escouade Mail inbox the code or link another service sends it by e-mail: give its address, collect the first e-mail received, read the code, and the limits to know.

## Integrations

- [MCP server](https://escouade.io/en/mail/docs/mcp.md): The Escouade Mail MCP server: its two addresses (agents, online assistants), its transport (Streamable HTTP), what it serves without and with a key, protocol versions, sessions, and the shape of a tool result and of a refusal.
- [HTTP API](https://escouade.io/en/mail/docs/api-http.md): Calling Escouade Mail without an MCP client: POST /v1/{operation}, the authorisation header, the shape of responses and refusals, cursor pagination, idempotency, rate, and the OpenAPI reference.
- [Webhooks](https://escouade.io/en/mail/docs/webhooks.md): The events the server reports through signed webhooks in the Standard Webhooks format (departure, delivery, bounce, refusal, reply, unsubscribe, objection), their envelope, the signature, retries, and reading them again by cursor with event_feed.
- [Connector for online assistants](https://escouade.io/en/mail/docs/connecteur.md): The Escouade Mail connector connects an online assistant (Claude, ChatGPT) to a space without copying a key: its address, signing in with the Escouade account, opening a space without an agent, what the human grants, how to remove access, and what a client needs to know about OAuth.

## Tools

- [Tool reference](https://escouade.io/en/mail/docs/reference/index.md): Every Escouade Mail tool: what it does, the key it needs, its parameters.
- [sign_up · Sign up (no key needed)](https://escouade.io/en/mail/docs/reference/sign_up.md): Sign up (no key needed).
- [verify · Verify the space](https://escouade.io/en/mail/docs/reference/verify.md): Verify the space.
- [attach_human · Attach your human](https://escouade.io/en/mail/docs/reference/attach_human.md): Attach your human.
- [open_workspace · Open Escouade Mail](https://escouade.io/en/mail/docs/reference/open_workspace.md): Open Escouade Mail.
- [navigate_workspace · Show a page in Escouade Mail](https://escouade.io/en/mail/docs/reference/navigate_workspace.md): Show a page in Escouade Mail.
- [workspace_events · Synchronise the workbench](https://escouade.io/en/mail/docs/reference/workspace_events.md): Synchronise the workbench.
- [inbox_status · Inbox status and quotas](https://escouade.io/en/mail/docs/reference/inbox_status.md): Inbox status and quotas.
- [workspace_snapshot · Refresh the space](https://escouade.io/en/mail/docs/reference/workspace_snapshot.md): Refresh the space.
- [activity_report · Today's summary and report](https://escouade.io/en/mail/docs/reference/activity_report.md): Today's summary and report.
- [list_events · Activity log](https://escouade.io/en/mail/docs/reference/list_events.md): Activity log.
- [event_feed · Event feed](https://escouade.io/en/mail/docs/reference/event_feed.md): Event feed.
- [billing_status · The space's plan](https://escouade.io/en/mail/docs/reference/billing_status.md): The space's plan.
- [subscribe · Get the payment link](https://escouade.io/en/mail/docs/reference/subscribe.md): Get the payment link.
- [cancel_subscription · Cancel the plan](https://escouade.io/en/mail/docs/reference/cancel_subscription.md): Cancel the plan.
- [list_inboxes · List inboxes](https://escouade.io/en/mail/docs/reference/list_inboxes.md): List inboxes.
- [create_inbox · Create an inbox](https://escouade.io/en/mail/docs/reference/create_inbox.md): Create an inbox.
- [update_inbox · Rename an inbox](https://escouade.io/en/mail/docs/reference/update_inbox.md): Rename an inbox.
- [delete_inbox · Delete an inbox](https://escouade.io/en/mail/docs/reference/delete_inbox.md): Delete an inbox.
- [request_inbox_review · Ask for a suspended inbox to be reinstated](https://escouade.io/en/mail/docs/reference/request_inbox_review.md): Ask for a suspended inbox to be reinstated.
- [create_app_password · Connect a phone or an app to an inbox](https://escouade.io/en/mail/docs/reference/create_app_password.md): Connect a phone or an app to an inbox.
- [list_app_passwords · An inbox's app passwords](https://escouade.io/en/mail/docs/reference/list_app_passwords.md): An inbox's app passwords.
- [revoke_app_password · Remove an app password](https://escouade.io/en/mail/docs/reference/revoke_app_password.md): Remove an app password.
- [add_domain · Register your domain](https://escouade.io/en/mail/docs/reference/add_domain.md): Register your domain.
- [verify_domain · Verify your domain](https://escouade.io/en/mail/docs/reference/verify_domain.md): Verify your domain.
- [list_domains · List your domains](https://escouade.io/en/mail/docs/reference/list_domains.md): List your domains.
- [domain_quality · A domain's quality](https://escouade.io/en/mail/docs/reference/domain_quality.md): A domain's quality.
- [remove_domain · Remove a domain](https://escouade.io/en/mail/docs/reference/remove_domain.md): Remove a domain.
- [send_email · Send an e-mail](https://escouade.io/en/mail/docs/reference/send_email.md): Send an e-mail.
- [list_threads · List conversations](https://escouade.io/en/mail/docs/reference/list_threads.md): List conversations.
- [classify_thread · Classify a conversation](https://escouade.io/en/mail/docs/reference/classify_thread.md): Classify a conversation.
- [inspect_domain · Prepare a mail domain](https://escouade.io/en/mail/docs/reference/inspect_domain.md): Prepare a mail domain.
- [list_contacts · List contacts](https://escouade.io/en/mail/docs/reference/list_contacts.md): List contacts.
- [get_contact · Read a contact record](https://escouade.io/en/mail/docs/reference/get_contact.md): Read a contact record.
- [save_contact · Save a contact](https://escouade.io/en/mail/docs/reference/save_contact.md): Save a contact.
- [set_contact_audiences · Choose a contact's audiences](https://escouade.io/en/mail/docs/reference/set_contact_audiences.md): Choose a contact's audiences.
- [list_audiences · List audiences](https://escouade.io/en/mail/docs/reference/list_audiences.md): List audiences.
- [list_campaign_templates · Campaign templates](https://escouade.io/en/mail/docs/reference/list_campaign_templates.md): Campaign templates.
- [save_campaign_template · Save a template](https://escouade.io/en/mail/docs/reference/save_campaign_template.md): Save a template.
- [save_audience · Save an audience](https://escouade.io/en/mail/docs/reference/save_audience.md): Save an audience.
- [get_audience · Read an audience](https://escouade.io/en/mail/docs/reference/get_audience.md): Read an audience.
- [import_contacts · Import contacts](https://escouade.io/en/mail/docs/reference/import_contacts.md): Import contacts.
- [remove_audience_contact · Remove a contact from the audience](https://escouade.io/en/mail/docs/reference/remove_audience_contact.md): Remove a contact from the audience.
- [list_campaigns · List campaigns](https://escouade.io/en/mail/docs/reference/list_campaigns.md): List campaigns.
- [save_campaign · Prepare a campaign](https://escouade.io/en/mail/docs/reference/save_campaign.md): Prepare a campaign.
- [get_campaign · Read a campaign](https://escouade.io/en/mail/docs/reference/get_campaign.md): Read a campaign.
- [preview_campaign · Review a campaign before sending](https://escouade.io/en/mail/docs/reference/preview_campaign.md): Review a campaign before sending.
- [campaign_action · Run a campaign](https://escouade.io/en/mail/docs/reference/campaign_action.md): Run a campaign.
- [campaign_metrics · A campaign's performance](https://escouade.io/en/mail/docs/reference/campaign_metrics.md): A campaign's performance.
- [campaign_history · A campaign's history](https://escouade.io/en/mail/docs/reference/campaign_history.md): A campaign's history.
- [get_thread · Read a conversation](https://escouade.io/en/mail/docs/reference/get_thread.md): Read a conversation.
- [reply_to_thread · Reply in a thread](https://escouade.io/en/mail/docs/reference/reply_to_thread.md): Reply in a thread.
- [close_thread · Close a conversation](https://escouade.io/en/mail/docs/reference/close_thread.md): Close a conversation.
- [get_message · Read a message and its log](https://escouade.io/en/mail/docs/reference/get_message.md): Read a message and its log.
- [list_drafts · Drafts awaiting approval](https://escouade.io/en/mail/docs/reference/list_drafts.md): Drafts awaiting approval.
- [update_draft · Correct a draft](https://escouade.io/en/mail/docs/reference/update_draft.md): Correct a draft.
- [approve_message · Approve a draft](https://escouade.io/en/mail/docs/reference/approve_message.md): Approve a draft.
- [cancel_message · Cancel a message](https://escouade.io/en/mail/docs/reference/cancel_message.md): Cancel a message.
- [attach_files · Attach files to a draft](https://escouade.io/en/mail/docs/reference/attach_files.md): Attach files to a draft.
- [remove_attachment · Remove an attachment](https://escouade.io/en/mail/docs/reference/remove_attachment.md): Remove an attachment.
- [get_attachment · Read an attachment](https://escouade.io/en/mail/docs/reference/get_attachment.md): Read an attachment.
- [add_suppression · Block an address or a domain](https://escouade.io/en/mail/docs/reference/add_suppression.md): Block an address or a domain.
- [remove_suppression · Lift a manual block](https://escouade.io/en/mail/docs/reference/remove_suppression.md): Lift a manual block.
- [list_suppressions · Unsubscribes](https://escouade.io/en/mail/docs/reference/list_suppressions.md): Unsubscribes.
- [get_settings · The space's settings](https://escouade.io/en/mail/docs/reference/get_settings.md): The space's settings.
- [update_settings · Adjust the space](https://escouade.io/en/mail/docs/reference/update_settings.md): Adjust the space.
- [list_keys · Access to the space](https://escouade.io/en/mail/docs/reference/list_keys.md): Access to the space.
- [create_key · Create an agent's key](https://escouade.io/en/mail/docs/reference/create_key.md): Create an agent's key.
- [revoke_key · Revoke an access](https://escouade.io/en/mail/docs/reference/revoke_key.md): Revoke an access.
- [set_webhook · Declare the space's webhook](https://escouade.io/en/mail/docs/reference/set_webhook.md): Declare the space's webhook.
- [remove_webhook · Remove the space's webhook](https://escouade.io/en/mail/docs/reference/remove_webhook.md): Remove the space's webhook.
- [close_space · Close the space](https://escouade.io/en/mail/docs/reference/close_space.md): Close the space.

## Reference

- [Errors](https://escouade.io/en/mail/docs/erreurs.md): The shape of a refusal (stable code, message in French, lead), what is not an error, and every server code with what to do.
- [FAQ](https://escouade.io/en/mail/docs/faq.md): The questions people ask about Escouade Mail, and the short answers: access, the key, the code, receiving and replying, the pace of sending, approval, unsubscribes, prices and payment.
- [Glossary](https://escouade.io/en/mail/docs/glossaire.md): Escouade Mail's terms, one per line: space, key, inbox, thread, draft, plan, warm-up, daily quota, working hours, block list, circuit breaker, and the word the server uses for each.
- [Help and contact](https://escouade.io/en/mail/docs/aide.md): What an agent sorts out on its own in Escouade Mail, what needs its human (code, payment, approval, DNS), and what needs an Escouade Mail administrator: lost key, suspended inbox, refund, caps. What to write, and to whom.

## Connect your agent

- [Connect my agent](https://escouade.io/en/mail/docs/brancher.md): An address to paste, a 6-digit code, a mission. In Claude or ChatGPT, you open your space yourself; an agent such as Claude Code signs up by itself, over MCP.
- [Connect Claude](https://escouade.io/en/mail/docs/brancher/claude.md): Claude connects to Escouade Mail through the connector, with no key to copy. Without a space, you open yours on the sign-in page; there you write, read threads, and correct and approve drafts.
- [Connect ChatGPT](https://escouade.io/en/mail/docs/brancher/chatgpt.md): ChatGPT connects to Escouade Mail through the connector. It accepts no key: you sign in with your Escouade account. Without a space, you open yours on the sign-in page; there you write, read threads, and correct and approve drafts.
- [Connect Claude Code](https://escouade.io/en/mail/docs/brancher/claude-code.md): One command, without a key. Your agent signs up by itself, then you run the command again with the key it received.
- [Connect Cursor](https://escouade.io/en/mail/docs/brancher/cursor.md): One file, without a key. Your agent signs up by itself, then you add to the file the header with the key it received.
- [Connect over HTTP](https://escouade.io/en/mail/docs/brancher/http.md): Without an MCP client, every tool is called as POST /v1/{operation}: the same arguments in JSON, the same object in return. No route exists that is not a tool.

## More

- ["Open source: the tools are open, the server stays closed"](https://escouade.io/en/mail/docs/open-source.md): What connects Escouade Mail is open, under the MIT licence. The server enforces the sending rules: it stays closed.
- [What's new](https://escouade.io/en/mail/docs/nouveautes.md): The dated log of what changes in Escouade Mail: the server, the tools, the documentation. Newest first.
- [Report abuse](https://escouade.io/en/mail/abus.md): You received an unwanted e-mail sent from an Escouade Mail inbox. How to stop receiving them, how to report it, and what happens next.