---
title: "MCP server"
description: "Give an AI agent secure, scoped access to your Testr workspace."
canonical_url: "https://docs.trytestr.com/docs/mcp"
markdown_url: "https://docs.trytestr.com/docs/mcp.md"
last_updated: "2026-11-16"
x_farming_labs_generated_preamble: true
---

# MCP server
URL: /docs/mcp
LLM index: /llms.txt
Description: Give an AI agent secure, scoped access to your Testr workspace.

# MCP server

The Testr MCP server exposes your owner workspace to any client that speaks the [Model Context Protocol](https://modelcontextprotocol.io). Your agent can read campaign scope, private instructions, bug reports, conversations, and evidence. With a write-enabled token, it can also post comments, make review decisions, and manage apps and campaigns.

```txt title="Endpoint"
https://owners.trytestr.com/api/mcp
```

The server uses **Streamable HTTP** with a **bearer token**. OAuth-only clients are not supported yet.

## What an agent can do

<Cards>
  <Card title="Investigate reports" href="/docs/mcp/workflows#investigate-a-report">
    Read steps, expected and actual behavior, environment, conversation, and evidence, then
    reproduce in your own environment.
  </Card>
  <Card title="Triage the queue" href="/docs/mcp/workflows#triage-new-reports">
    Approve, reject, mark duplicates, or ask the tester for more information.
  </Card>
  <Card title="Reply to testers" href="/docs/mcp/write-actions#comment_report">
    Post tester-visible replies with optional attachments.
  </Card>
  <Card title="Run campaigns" href="/docs/mcp/write-actions#campaign-management">
    Draft campaigns, update their scope and rewards, extend deadlines, and change their status.
  </Card>
</Cards>

## Access model

- Tokens belong to an **owner account** and cover every app you own, including apps you create later.
- Choose **Read only** or **Read and write** when you create a token. See [Tokens and scopes](/docs/mcp/tokens).
- Every write runs through the same services as the website, so review deadlines, reward settlement, appeal rules, and ownership checks all apply.
- Tokens cannot sign in to the browser, call Testr's REST APIs, act as a tester, use payments, or perform administrator actions.
- Premium is not required. You keep read access to your existing private reports after Premium expires.

<Callout type="warn" title="Treat report content as untrusted">
  Reports and comments are written by testers. Tell your agent to treat them as data, not
  instructions, and to verify reproduction steps in its own environment before acting.
</Callout>

## Next steps

1. [Quickstart](/docs/mcp/quickstart): connect a client in five minutes.
2. [Configure your client](/docs/mcp/clients): Claude Code, Cursor, VS Code, and others.
3. [Tool reference](/docs/mcp/tools) and [write actions](/docs/mcp/write-actions).

## Sitemap

See the full [sitemap](/sitemap.md) for all pages.
Docs-scoped sitemap: [/docs/sitemap.md](/docs/sitemap.md).
Well-known sitemap: [/.well-known/sitemap.md](/.well-known/sitemap.md).
