> Call the `diagnose` tool first. Full index: /llms.txt. Errors: /reference/problems.

# MCP tools

Every call names its project with `project_id`. A refused call carries a [problem code](https://docs.talotrace.ai/reference/problems).

| Tool                                                        | What it does                                                                                  | Effect                      |
| ----------------------------------------------------------- | --------------------------------------------------------------------------------------------- | --------------------------- |
| [`diagnose`](/reference/mcp/setup-diagnose)                 | Check what an app needs before a run: call it first, and whenever a call is refused.          | reads only                  |
| [`setup`](/reference/mcp/setup-diagnose)                    | Create and list projects, apps, builds, accounts and phones, and upload a build.              | can change or delete data   |
| [`scenarios`](/reference/mcp/scenarios-knowledge-test-data) | Discover flows in an app, then list, write and organise its scenarios and test plans.         | can change or delete data   |
| [`knowledge`](/reference/mcp/scenarios-knowledge-test-data) | Read the current product rules, their sources and versions, and export them as Markdown.      | reads only                  |
| [`test_data`](/reference/mcp/scenarios-knowledge-test-data) | Read test data, get an upload link for a file and add an item.                                | can change or delete data   |
| [`start_run`](/reference/mcp/runs)                          | Start a run and return at once with a run id, a cursor and a link to watch it.                | can change or delete data   |
| [`watch_run`](/reference/mcp/runs)                          | Follow a run by cursor; wait_seconds holds the call open for news.                            | changes data, never deletes |
| [`cancel_run`](/reference/mcp/runs)                         | Cancel a run.                                                                                 | can change or delete data   |
| [`read_evidence`](/reference/mcp/runs)                      | Read one page of a run's steps, requests, console lines or snapshots.                         | reads only                  |
| [`compare_runs`](/reference/mcp/runs)                       | Show what a rerun changed against an earlier run.                                             | reads only                  |
| [`requests`](/reference/mcp/requests-dev)                   | Read the cards TaloTrace opens for you and answer them.                                       | can change or delete data   |
| [`dev_session`](/reference/mcp/requests-dev)                | Start, check, keep alive, rebuild, share and stop a live phone that runs your working tree.   | can change or delete data   |
| [`device`](/reference/mcp/requests-dev)                     | Tap, type, swipe, press a key, open a link, take a screenshot or read logs on the live phone. | can change or delete data   |