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 day | your plan's daily searches, shared with the API and the website |
| Rows per query | your plan's limit |
| Rows per query with snippets | your plan's limit; spends a search and a snippet search |
| Result depth | rows 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 cluster | your plan's limit |
| Extraction points per day | your plan's allowance, shared with the API and the website |
| Clusters per account | 100 |
| Rate | ten 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.
| Code | Meaning |
|---|---|
plan_required | No paid plan. The answer names the plans and prices, with a link to the pricing page. |
empty_query | No query. |
page_too_deep | page times rows goes past the rows per query of the plan. |
too_many_requests | Over the rate limit above; retry_after says how many seconds to wait. |
quota_exceeded | The day's searches are used up; resets_at says when they return. |
snippet_quota_exceeded | The day's snippet searches are used up; searching without snippets still works. |
cluster_not_found | No cluster with that id on the account; list_clusters shows them. |
cluster_limit | The account already keeps 100 clusters; delete some first. Nothing was deleted. |
domains_not_found | None of the domains given to create_cluster is in the index; no cluster was created. |
invalid_regex | An expression is not a regular expression in slashes or pipes, up to 200 characters. |
unknown_field | No field with that name; the message lists them. |
unknown_preset | No preset with that name; the message lists them. |
extract_quota_exceeded | The 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 see | What it means |
|---|---|
| The assistant asks to sign in again, or reports 401 | The 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 registration | The 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 screen | The 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 token | The client still holds the old connection. Restart it. |