# Testery MCP Server

The Testery MCP Server allows AI assistants like Claude to interact directly with your Testery account. Using the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/), you can manage projects, trigger test runs, review results, and more — all through natural language conversation.

## Prerequisites

* [Claude Code](https://docs.anthropic.com/en/docs/claude-code) installed
* A [Testery account](https://testery.com/signup?plan=2)

## Setup

### Step 1: Add the MCP Server

Run the following command to add the Testery MCP server to Claude Code:

```bash
claude mcp add testery --transport http "https://mcp.testery.io/mcp"
```

### Step 2: Authenticate

In your Claude Code session, type:

```
/mcp
```

This will open an authentication flow where you can log in with your Testery account. Once authenticated, Claude will have access to your Testery data.

## What You Can Do

Once connected, you can ask Claude to interact with Testery using natural language. For example:

* "List all my Testery projects"
* "Create a new test run for project X"
* "Show me the test results for the latest test run"
* "List environments for project Z"
* "Get details about test suite A"

The MCP server supports the following Testery resources:

| Resource          | Capabilities                      |
| ----------------- | --------------------------------- |
| **Projects**      | List, get, create, update, delete |
| **Test Runs**     | List, get, create, delete         |
| **Test Results**  | List, get                         |
| **Environments**  | List, get, create, update, delete |
| **Test Suites**   | List, get, create, update, delete |
| **Users**         | List, get                         |
| **Organizations** | List, get                         |

## Troubleshooting

**Authentication Issues**

* Run `/mcp` again to re-authenticate
* Make sure you are logging in with the correct Testery account

**Permission Denied**

* Check your organization and project access rights in Testery


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.testery.io/integrations/testery-mcp-server.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.