# Testsy docs

> Testsy runs plain-English QA tests in a real Chrome or on iPhone and Android apps and returns the verdict, the value behind every check, a replay and a fix prompt. REST API: https://app.testsy.dev/api/v1 (Authorization: Bearer <key>). MCP server: https://app.testsy.dev/mcp (Streamable HTTP, same key).

## Get started

- [Testsy docs](https://testsy.dev/docs/): Describe what a tester should do and check, in plain English. Testsy runs it in a real Chrome, or on iPhone and Android apps, and comes back with the verdict, the value behind every check, a replay and a fix prompt.
- [Quickstart](https://testsy.dev/docs/quickstart/): Your first test and its result in about five minutes. No card needed.
- [How a run works](https://testsy.dev/docs/how-it-works/): What happens between pressing Run and the verdict, and what you can watch while it happens.

## Write tests

- [Write a test with the assistant](https://testsy.dev/docs/write-a-test/): Describe the test in plain English; the assistant drafts the steps and checks, you review and confirm, and the tester follows them as written.
- [Write it yourself](https://testsy.dev/docs/write-it-yourself/): Skip the assistant and write the test as plain text; the tester plans from it at run time.
- [Steps, checks and values](https://testsy.dev/docs/steps-checks-values/): How to write steps the tester can follow and checks it can judge, and how to have it read values for you.
- [Sign-in accounts](https://testsy.dev/docs/sign-in-accounts/): Let the tester sign in without a password ever reaching the AI or your test text.
- [Test files](https://testsy.dev/docs/test-files/): Files the tester can upload during a test, such as a CSV to import or an image for a profile.
- [Mailbox, phone number and endpoints](https://testsy.dev/docs/mailbox-phone-endpoints/): Give a run its own email address or phone number, or let it call into your own system, for sign-ups, codes and test data.
- [Test options](https://testsy.dev/docs/test-options/): Every setting a test has, with the values the app, the API and MCP accept.
- [Android and iOS apps](https://testsy.dev/docs/apps/): Test your app on an iPhone or an Android device: upload a build, write the test the same way, and get the same proof.

## Run and read results

- [Run a test](https://testsy.dev/docs/run-a-test/): Every way to start a run, what happens when your plan's runs are used, and how to stop one.
- [Schedules](https://testsy.dev/docs/schedules/): Run a test by itself every night, on weekdays, or on chosen days, at a time in your time zone.
- [Verdicts and what counts](https://testsy.dev/docs/verdicts/): What each result means, which ones count toward your plan, and which fail a CI build.
- [Proof, replay and video](https://testsy.dev/docs/results/): Every result shows what was decided, on which value, read where on the screen, with the replay, the video and the logs behind it.
- [Fix prompt](https://testsy.dev/docs/fix-prompt/): One click turns a failure into a prompt for Claude Code, Cursor, Codex or any coding agent.
- [Share links](https://testsy.dev/docs/share-links/): A read-only link to one result that anyone can open without signing in, until it expires or you turn it off.
- [Email and Slack](https://testsy.dev/docs/notifications/): Hear about failures without watching: email, Slack, or one email for one run.

## Automate

- [Run tests in CI](https://testsy.dev/docs/ci/): Run a project's tests after every deploy, fail the build when a check fails, and keep the result with the commit. One file, no dependencies, any CI.
- [Command-line tool](https://testsy.dev/docs/cli/): qa-ai.mjs: one file, Node 18 or later, no dependencies. Runs tests, waits for the verdicts, writes JUnit and uploads app builds.
- [App builds from CI](https://testsy.dev/docs/app-builds-ci/): Upload the build your pipeline just made and run the app's tests on it, in the same step.
- [AI agents (MCP)](https://testsy.dev/docs/mcp/): Let Claude Code, Cursor, Codex or any MCP client write tests, run them, read the results and share the proof, with the same actions you have in the app.

## Reference

- [API reference](https://testsy.dev/docs/api/): Everything the app does with tests and runs, over HTTPS. Each endpoint is also an MCP tool with the same name and parameters.
- [API: Workspace](https://testsy.dev/docs/api/workspace/): Workspace: Get the workspace, Get usage, Get network settings, Set the browsing country.
- [API: Projects](https://testsy.dev/docs/api/projects/): Projects: List projects, Get a project, Create a project, Update a project, Archive a project.
- [API: Tests](https://testsy.dev/docs/api/tests/): Tests: List tests, Get a test, Create a test, Update a test, Archive a test.
- [API: Test plans](https://testsy.dev/docs/api/test-plans/): Test plans: Draft or revise a plan.
- [API: Test files](https://testsy.dev/docs/api/test-files/): Test files: List a test's files, Add a test file, Delete a test file.
- [API: Sign-in accounts](https://testsy.dev/docs/api/sign-in-accounts/): Sign-in accounts: List sign-in accounts, Add a sign-in account, Delete a sign-in account.
- [API: Endpoints](https://testsy.dev/docs/api/endpoints/): Endpoints: List endpoints, Add an endpoint, Delete an endpoint.
- [API: Runs](https://testsy.dev/docs/api/runs/): Runs: Run a test, Run a project, List runs, Get a run, Stop a run, Download a run file.
- [API: Share links](https://testsy.dev/docs/api/share-links/): Share links: List share links, Create a share link, Turn off a share link.
- [API: Schedules](https://testsy.dev/docs/api/schedules/): Schedules: List schedules, Create a schedule, Pause or resume a schedule, Delete a schedule.
- [API: App builds](https://testsy.dev/docs/api/app-builds/): App builds: List builds, Get a build, Start a build upload, Upload a build part, Complete a build upload, Delete a build.
- [Errors and limits](https://testsy.dev/docs/errors-limits/): The error codes the API and MCP tools answer with, and the limits that apply to tests, files, builds and requests.

## Workspace

- [Team and roles](https://testsy.dev/docs/team-roles/): Who can see, write, run and manage what in a workspace, and how to invite people.
- [API keys](https://testsy.dev/docs/api-keys/): Keys for CI, scripts and AI agents: what each kind may do, and how to create and revoke them.
- [Plans and billing](https://testsy.dev/docs/plans-billing/): What each plan includes, what counts as a run, and how to upgrade or buy extra runs.
- [Network and allow-listing](https://testsy.dev/docs/network/): How our browsers reach your site, the addresses to allow when a firewall or bot protection blocks them, and the country they browse from.
- [Security and data](https://testsy.dev/docs/security/): How passwords, keys and links are kept, what the AI sees, and how to delete your data.