Start free
Tools

Projects and runs tools

Nine tools to create projects, ask research questions, follow runs, approve plans, and read Sleuth’s answers.

Research runs are the only MCP calls that use credits. See How a research run works for the order to call these in.

create_project

Create a new research project. Returns project_id and status idle.

InputTypeNotes
name requiredstring1 to 255 characters

send_message

Send a research question, an answer to a clarification, or an action to a project. Send exactly one of message or action. Returns a 202 acknowledgement right away.

InputTypeNotes
project_id requiredstringProject UUID
messagestringThe question or clarification answer
actionstringcancel, approve_plan, approve_schema, reject_plan, or reject_schema
feedbackstringOnly with reject_plan or reject_schema. Tells Sleuth what to change.

To attach files, call upload_document first. Credits: a research question uses one credit per analytical cell the run fills.

get_project

Get the full project state, including its status. This is the main polling call. When the status is awaiting_clarification, read the latest message with get_messages and answer with send_message.

InputTypeNotes
project_id requiredstringProject UUID

Respect the retry_after hint, in seconds, between polls.

wait_for_update

Wait until the project’s status changes, or until the time budget runs out. Returns the latest state, plus status_changed and waited_seconds. Chain calls for long runs.

InputTypeNotes
project_id requiredstringProject UUID
timeout_secondsnumberDefault 180, maximum 300

get_messages

List the user and Sleuth messages in a project, including Sleuth’s written answers and questions.

InputTypeNotes
project_id requiredstringProject UUID
limitinteger1 to 200, default 50
offsetintegerDefault 0

list_projects

List the projects the signed-in user or key can see.

InputTypeNotes
limitinteger1 to 100, default 20
offsetintegerDefault 0

update_project

Rename a project.

InputTypeNotes
project_id requiredstringProject UUID
name requiredstringThe new name

delete_project

Delete a project and everything in it. This can’t be undone, so confirm with the user first.

InputTypeNotes
project_id requiredstringProject UUID

export_project

Export a full snapshot of a project. It can be very large, and datasets are capped at 10,000 rows each. Prefer the dataset and chart tools when an agent only needs part of it.

InputTypeNotes
project_id requiredstringProject UUID