Start free
Overview

Errors and limits

Every limit an agent can hit on the Sleuth MCP server, and what to do about each error.

Limits

WhatLimit
File upload through MCP10 MB per file, decoded. Upload larger files in Studio.
Rows per get_dataset call50 by default, up to 2,000
Rows per dataset in export_project10,000
One wait_for_update callUp to 300 seconds. Chain calls for longer runs.
Messages per get_messages callUp to 200
Projects per list_projects callUp to 100
Results per research library searchUp to 100
Passages per query_research_document callUp to 50
Matches per search_documents callUp to 50
Download linksShort-lived. Ask for a new one.
Research runs at once, per API key10. More returns run_limit_exceeded.
Explore datasetsRow caps by anchor. explore_get_filters lists them.

Errors and fixes

You seeWhat it meansFix
onboarding_requiredThe account isn't set up yet.Call get_onboarding_status and follow next_action. Onboarding
Waiting for approvalA new access request is with Sleuth.Tell the user they'll get an email, then reconnect.
Out of credits, trial ended, or payment failedThe workspace can't start new research. Sleuth's message says which, and links to plans or billing.Show Sleuth's message as it is. If you run out of credits
run_limit_exceededAn API key already has 10 research runs going.Wait for one to finish, then send again.
409 or "project busy"A research run is already going on that project.Don't send again. Wait with wait_for_update until the run finishes, or send cancel if the user wants to stop it.
"Can't reach the storage host" when fetching a linkThe AI tool's sandbox can't reach the download address. That's the client, not Sleuth.Give the user the link to open in a browser.
403 with an API keyAPI access isn't on for this organization.Contact Sleuth. API
422 from get_artifact_svgThe artifact isn't a chart.Use get_artifact instead.
No matches right after an uploadThe document is still being indexed.Wait a minute and search again.
Ambiguous filter valueA term matched more than one Explore value.Ask the user which one they meant.
Expired or broken download linkLinks last minutes.Call the tool again for a fresh link.
Sell-side download refusedThe organization doesn't have download access.Read passages with query_research_document, or talk to Sleuth about access.
Run status failedThe run stopped. It doesn't use credits.Read the last message, then try again or contact Sleuth.
Sign-in loops or "not allowed"The client didn't finish OAuth, or the connection is stale.Remove and re-add the connector, then sign in again. Fix connection problems

For anything else, the user can email support@sleuthinsights.com.