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.

Result
{
  "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

StatusCodeWhat to do
401MISSING_AUTH_HEADERNo token. OAuth apps start the sign-in from here; with a key, send Authorization: Bearer.
401INVALID_TOKENThe access token expired or was revoked. The app renews it by itself or asks you to connect again.
401INVALID_API_KEYThe key is wrong, deleted or expired. Create a new one.
401WRONG_CREDENTIAL_TYPEA mailbox token on the account server (or the other way around). Use the right URL.
403ACCOUNT_BLOCKEDThe account is blocked. Contact support.
403IP_NOT_ALLOWEDThe key is locked to other IPs. Add the IP or use OAuth.
429RATE_LIMITEDToo 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.