Limits and errors - Documentation

Request limits

Every MCP tool call counts as one API request. MCP tool calls and REST API requests share the same limit. The limit applies to the organization that the tool acts on.

Your plan sets the number of requests per minute:

Plan	Requests per minute
Free	No API access
Base	60
Pro	120

When the organization reaches the limit, the server rejects the request until the minute ends. The REST API returns status 429 Too Many Requests with a Retry-After header.

The plan limits also apply to the MCP server. For example, a tool cannot create a link when the organization has reached the maximum number of links for its plan.

Errors

When a tool call fails, the server returns an error message to your assistant. The assistant usually explains the error to you.

Error	Cause	What to do
HTTP `401 Unauthorized`	The token is missing, incorrect or deleted.	Check the `Authorization` header. Create a new token if necessary.
`Your plan does not include API access.`	The organization is on the Free plan.	Upgrade the organization to Base or Pro.
`You have reached your API rate limit of 60 requests per minute. Try again in 42 seconds.`	The organization has used all its API requests for the current minute.	Wait the number of seconds in the message, or upgrade the plan.
`You don't have access to this organization.`	The `organization_id` is for an organization that you are not a member of.	List your organizations and use one of their IDs.
`Organization not found.`	No organization has that `organization_id`.	List your organizations and use one of their IDs.
`You do not belong to any organization.`	Your user has no organization.	Create an organization in the dashboard.
`Link not found.`, `Domain not found.`, `Tag not found.`, `Campaign source not found.`, `Campaign medium not found.`	The ID does not exist in the organization.	List the items first to find the correct ID.
`You have reached the maximum number of links for your plan.`	The organization has reached its link limit.	Delete links that you do not use, or upgrade the plan.
`You have reached the maximum number of domains for your plan.`	The organization has reached its domain limit.	Delete a domain, or upgrade the plan.
`Free users can only use the short domain: ...`	A Free plan organization tried to use a domain that is not the short domain.	Use the short domain, or upgrade the plan.
A validation message, for example `The url field must be a valid URL.`	An argument has an incorrect value or format.	Correct the argument. Dates use the format `d/m/Y H:i`, for example `31/12/2026 18:00`.