# Developer documentation

> Integrate Probara with the REST API and MCP.

Automate Probara: call the public REST API from CI and scripts, or connect an MCP client so an AI agent can operate projects, suites, cases, runs, and defects directly. Every mutating API operation is gated by an organization permission — a `viewer` receives `403 forbidden` on every write, and some writes (such as creating a project) require an `owner`/`admin` role.

## Available today

- Product usage is documented under [Guides](https://docs.probara.net/en/guides/).
- **REST base path:** integrators and the web app MUST call **`/api/v1`** (for example `GET /api/v1/health`). Unversioned `/api/...` routes return `404 not_found`.
- **[API authentication](https://docs.probara.net/en/developers/authentication/)** — organization-scoped API tokens (`Authorization: Bearer`) for scripts, and organization app tokens for reporting from CI; session cookies remain for the web app. The MCP endpoint additionally accepts OAuth 2.1 access tokens for interactive clients.
- **[CI integrations](https://docs.probara.net/en/developers/ci-integrations/)** — report test results from any CI with an app token (paid plans): choose between the CLI and the Playwright, Jest, Cypress, Vitest and Cucumber reporters.
- **[CLI](https://docs.probara.net/en/developers/cli/)** — report JUnit XML results from any CI with `@probara/cli`.
- **[Playwright reporter](https://docs.probara.net/en/developers/ci-integrations/playwright/)** — send every Playwright attempt, with its steps and attachments, with `@probara/playwright-reporter`.
- **[Jest reporter](https://docs.probara.net/en/developers/ci-integrations/jest/)** — send every Jest attempt, with its steps, attachments and links, and run only the tests of a Probara run, with `@probara/jest-reporter`.
- **[Cypress reporter](https://docs.probara.net/en/developers/ci-integrations/cypress/)** — send every Cypress attempt, with its steps, its failure screenshots and links, and run only the tests of a Probara run, with `@probara/cypress-reporter`.
- **[Vitest reporter](https://docs.probara.net/en/developers/ci-integrations/vitest/)** — send every Vitest attempt and repeat, with its steps, attachments and links, and run only the tests of a Probara run, with `@probara/vitest-reporter`.
- **[REST API reference](https://docs.probara.net/en/developers/api-reference/)** — overview (base URL, errors, pagination).
- **[Interactive API reference (v1)](https://docs.probara.net/en/developers/api-reference/v1/)** — OpenAPI 3.1 viewer.
- **[MCP server](https://docs.probara.net/en/developers/mcp/)** — connect any MCP-compatible client (Claude.ai, Claude Code, Cursor, ChatGPT) to `https://app.probara.net/mcp` with OAuth 2.1 or an API token.
- **[MCP tool reference](https://docs.probara.net/en/developers/mcp-tools/)** — the full generated list of every tool the server exposes, regenerated from the worker registry so it never drifts.
- **[SCIM provisioning](https://docs.probara.net/en/developers/scim/)** — the SCIM 2.0 endpoint an identity provider calls to provision people and groups, on the Enterprise plan.
- **Markdown for agents** — every guide and developer page is also served as plain Markdown: replace the trailing slash with `.md` (for example [`/en/developers/authentication.md`](https://docs.probara.net/en/developers/authentication.md)). [`/llms.txt`](https://docs.probara.net/llms.txt) lists them all, so a coding agent can read the docs without parsing HTML.

## Topic status

| Topic                                                           | Status                                                          |
| --------------------------------------------------------------- | --------------------------------------------------------------- |
| API authentication                                              | <span class="dev-status dev-status--available">Available</span> |
| REST API reference (overview)                                   | <span class="dev-status dev-status--available">Available</span> |
| Interactive reference (v1)                                      | <span class="dev-status dev-status--available">Available</span> |
| MCP server                                                      | <span class="dev-status dev-status--available">Available</span> |
| MCP tool reference                                              | <span class="dev-status dev-status--available">Available</span> |
| [CI reporters / result upload](https://docs.probara.net/en/developers/ci-integrations/) | <span class="dev-status dev-status--available">Available</span> |
| Probara CLI                                                     | <span class="dev-status dev-status--available">Available</span> |
| SCIM provisioning (Enterprise plan)                             | <span class="dev-status dev-status--available">Available</span> |

When a new capability ships, this section adds its authentication steps, examples, and stable endpoint documentation generated from the shared Zod contracts in the monorepo.