Limits and errors

The MCP server spends the same quota as the API and the website, and when it refuses, it says why in words the assistant can pass on to you.

Limits

The MCP server needs a paid plan. Without signing in, only the tool list and read_docs work. A free account can connect and call read_docs and account; every other tool answers plan_required. Pro is also sold as a one-day or one-week pass - see the pricing page.

Paid plan
Searches per dayyour plan's daily searches, shared with the API and the website
Rows per queryyour plan's limit
Rows per query with snippetsyour plan's limit; spends a search and a snippet search
Result depthrows past your plan's depth in the popularity ranking are left out, not blanked: truncated is true, returned is below rows, total still counts them - see Result depth
Domains per clusteryour plan's limit
Extraction points per dayyour plan's allowance, shared with the API and the website
Clusters per account100
Rateten calls of search and the cluster tools a minute per account, shared with the API; account and read_docs do not count - see Quotas and rate limits

account shows your exact numbers, and the answers of search and create_cluster carry what is left as quota. Searches reset at midnight UTC.

Errors

A refused search is not a protocol error: the tool answers with isError: true, a message the assistant can pass on to you, and a code in the structured data.

CodeMeaning
plan_requiredNo paid plan. The answer names the plans and prices, with a link to the pricing page.
empty_queryNo query.
page_too_deeppage times rows goes past the rows per query of the plan.
too_many_requestsOver the rate limit above; retry_after says how many seconds to wait.
quota_exceededThe day's searches are used up; resets_at says when they return.
snippet_quota_exceededThe day's snippet searches are used up; searching without snippets still works.
cluster_not_foundNo cluster with that id on the account; list_clusters shows them.
cluster_limitThe account already keeps 100 clusters; delete some first. Nothing was deleted.
domains_not_foundNone of the domains given to create_cluster is in the index; no cluster was created.
invalid_regexAn expression is not a regular expression in slashes or pipes, up to 200 characters.
unknown_fieldNo field with that name; the message lists them.
unknown_presetNo preset with that name; the message lists them.
extract_quota_exceededThe day's extraction points are used up; resets_at says when they return. A call that runs out midway returns what it has, with stopped.

When the assistant cannot connect

What you seeWhat it means
The assistant asks to sign in again, or reports 401The call needs an account and there is no token yet, or the token was mistyped, deleted or disconnected on your profile page; the message says which. Sign in, or issue a new token.
OAuth fails before the PublicWWW sign-in page, for example with does not support dynamic client registrationThe client wants to register itself, which PublicWWW does not support: use a token in the header (in opencode and MiMo Code also "oauth": false).
An error page on PublicWWW instead of the Allow screenThe client's identity document could not be read, or its return address is not in it. Nothing was granted; try again later or use a token.
An error right after adding a tokenThe client still holds the old connection. Restart it.
Next For developers