What your agent can do on Email
Connect your Email account once and your AI agent can use 25 tools on it, through one MCP server or the REST API. Every action stays inside the Email limits that keep the account safe.
In plain words
- Read and answer the emails customers send you, on the same thread
- Send one email to one person who expects to hear from you
- Find an email by sender, folder or date, and open its attachments
- Save a draft for you to check and send yourself
Every tool
Some tools work on every channel where the platform supports them. If Email does not support an action, Spaces returns an error and nothing is sent. Writes need an Idempotency-Key, so a retry never sends twice.
| What it does | MCP tool | REST |
|---|---|---|
| Your emails, newest first. Filter by folder, by address or by date. | list_emails | GET …/emails |
| The contacts saved in your mailbox. | list_email_contacts | GET …/email-contacts |
| One email, with its text and attachments. | get_email | GET …/emails/{email_id} |
| Send one email to one person, or reply on a thread. Never a bulk send. | send_email | POST …/emails |
| Move an email to the trash. | delete_email | DELETE …/emails/{email_id} |
| Mark an email read or unread, or move it to another folder. | update_email | PATCH …/emails/{email_id} |
| A file attached to an email. | get_email_attachment | GET …/emails/{email_id}/attachments/{attachment_id} |
| Your mail folders, such as the inbox and sent mail. | list_email_folders | GET …/email-folders |
| One mail folder. | get_email_folder | GET …/email-folders/{folder_id} |
| Save an email as a draft for you to check and send yourself. | create_email_draft | POST …/email-drafts |
Pause and approvals
| What it does | MCP tool | REST |
|---|---|---|
| Stop every message, post, comment, invitation, scheduled message and routine at once. Reading keeps working. | pause_all_sending | POST /v1/messaging/pause |
| Start sending again after a pause. Waiting scheduled messages and routines carry on. | resume_all_sending | POST /v1/messaging/resume |
Accounts
| What it does | MCP tool | REST |
|---|---|---|
| The accounts you have connected, with their status and when each last had activity. Search by name, filter by channel or status, sort and page. | list_messaging_accounts | GET /v1/messaging/accounts |
| A link to connect a new account, or to reconnect one. | create_messaging_connect_link | POST /v1/messaging/accounts/connect-link |
| Disconnect an account. | disconnect_messaging_account | DELETE … |
| Status of one connected account. | get_connected_account | GET … |
| Start reconnecting an account that needs a sign-in. | reconnect_account | POST …/reconnect |
| Enter a sign-in or verification code the platform asked for. The code is not stored. | solve_checkpoint | POST …/checkpoint |
| Ask the platform to send the verification code again. | resend_checkpoint | POST …/checkpoint/resend |
| Restart an account that has stopped syncing. | restart_account | POST …/restart |
| Fetch an account’s messages again from the platform. | resync_account | POST …/sync |
Usage and billing
| What it does | MCP tool | REST |
|---|---|---|
| Messages sent today and this week, and how much room is left on each account. | get_messaging_usage | GET /v1/messaging/usage |
| Usage by day for each account, as a spreadsheet or JSON: messages sent, new conversations and other actions. No message text. | export_messaging_usage | GET /v1/messaging/usage/export |
| Your plan and billing status. | get_messaging_billing | GET /v1/messaging/billing |
| A checkout link to choose a plan. | create_messaging_billing_checkout | POST /v1/messaging/billing/checkout |
Connect it
Use https://api.spacesos.com/mcp/email for an MCP server with only the Email tools, or https://api.spacesos.com/mcp for every channel. Setup steps for each AI client. An overview for Email: Email API for AI agents.
Other channels: WhatsApp, Instagram, LinkedIn, Messenger, X.