Errors & limits

What can go wrong, and the boundaries to design around.

Errors

401

Unauthorized

Missing, malformed, expired, or revoked credentials. Check the Authorization header or re-run the OAuth connect; generate a fresh token if needed.

404

Not found

The endpoint URL is wrong. It must be exactly https://mcp.lemon.domains/mcp.

tool error

“You are not a member of this project”

The projectId belongs to a project you cannot access, or you only have viewer access on a write. Call list_projects to see your projects and roles.

tool error

“This domain already exists in this registrar account”

A domain name is unique per registrar account. Use update_domain instead, or choose a different account.

access denied

OAuth sign-in succeeds but no data

The email you signed in with does not match a Lemon Domains account. Sign in with the same email as your account.

Transport. Streamable HTTP only; the legacy SSE transport is disabled.
Batch size. bulk_add_domains accepts up to 200 domains per call.
Request timeout. Individual requests run for up to 60 seconds.
Scopes. Tokens currently grant full read + write access; per-token scopes are planned.

Need something the tools don't cover yet? Let us know. The surface is growing.