AI apps (MCP)
Errors & limits
What a failed tool looks like, what each connection error means, and the limits every AI app works within.
Tool errors
When a command fails (domain not found, no credits, invalid address…) the tool returns a normal result with isError: true. The text is CODE: message, with the same codes as the API, so the app can fix the arguments and try again.
{
"content": [{ "type": "text", "text": "DOMAIN_NOT_FOUND: Domain not found or does not belong to this account." }],
"structuredContent": { "code": "DOMAIN_NOT_FOUND", "message": "Domain not found or does not belong to this account." },
"isError": true
}Connection errors
| Status | Code | What to do |
|---|---|---|
| 401 | MISSING_AUTH_HEADER | No token. OAuth apps start the sign-in from here; with a key, send Authorization: Bearer. |
| 401 | INVALID_TOKEN | The access token expired or was revoked. The app renews it by itself or asks you to connect again. |
| 401 | INVALID_API_KEY | The key is wrong, deleted or expired. Create a new one. |
| 401 | WRONG_CREDENTIAL_TYPE | A mailbox token on the account server (or the other way around). Use the right URL. |
| 403 | ACCOUNT_BLOCKED | The account is blocked. Contact support. |
| 403 | IP_NOT_ALLOWED | The key is locked to other IPs. Add the IP or use OAuth. |
| 429 | RATE_LIMITED | Too many requests at once. Wait the Retry-After seconds and try again. |
Limits
Same rate limits as the API
Each connection counts against the same per-key or per-mailbox limits as your API calls.
1 MB per call
Arguments are limited to 1 MB per call, so attachments sent through an AI app must be small.
Credits and daily limit
Every email sent uses your credits (one per recipient) and counts towards your daily limit.
Confirmation before acting
Tools that send email or delete data are marked destructive, so the app asks you before running them.
Sending email follows the same rules as the Send Email API. Back to MCP overview.