Limits and errors

Access errors

What you see	What it means	What to do
401	The server doesn’t recognise the sign-in or key: missing, expired or revoked, or you are no longer in that account	A connected AI renews itself. If it asks you to sign in, do it. If you disconnected the AI, connect it again. A script with a revoked access key needs a new one. If you were removed from the account, that access key and that connection no longer work
403	The address you use isn’t the server’s	Copy the exact address from the AI & MCP tab
The permission screen says the request expired	More than 10 minutes passed	Go back to the AI and start the connection again
“Still here?” after allowing	The AI stopped waiting for the answer	Go back to the AI, start the connection and allow again

Errors when asking for a search

They come back as the tool’s answer; your AI explains them to you.

Message	What it means	What to do
Not started: confirm is not true	The AI didn’t confirm with you	Say yes; the AI repeats the call with confirm
Not enough tokens, with the numbers	The balance doesn’t cover the cap	Buy a pack under Buy tokens, ask to search with what you have (acceptCut, if you have at least 1 token) or wait for the month’s tokens
maxTokens above the connection’s cap	The AI asked for more than you allowed	Let it use the cap, or connect the AI again with a higher cap
A platform isn’t in your plan	Your plan doesn’t include that platform	Leave it out of the request or change plan
Your plan doesn’t include daily tracking	Only Agency and Enterprise have it	Ask for a normal search or change plan
Date range too long	Over the days your plan allows	Shorten the dates
That’s a lot of searches in one minute	The same limit as on the site	Wait a moment
You have N searches waiting or running	Queue full	Wait for some to finish
You’ve started the most searches for one day	Daily cap on starts	Try again later
No such search in this account	The id isn’t the connected account’s or was deleted	Ask the AI to list your searches

Note

estimate_search spends nothing. Ask the AI to estimate before starting and you avoid most of these notices.

How long things last

What	Lasts
Permission request in the browser	10 minutes
Sign-in of a connected AI	1 hour; renews itself
Renewal of that sign-in	30 days from the last use; then sign in again
Connection under Connected apps	Until you disconnect it
Access key	Until you revoke it

Other limits

• Up to 10 live access keys per person, across all your accounts.
• The token cap per search goes from 1 to 1,000, on a connection and on an access key alike.
• A call with limit out of range is refused: 1 to 50 on list_searches, 1 to 100 on get_posts.