# TestOptim MCP server

> Allows AI assistants to run QA test suites on web applications, explore new pages, and retrieve detailed bug reports with reproduction steps.

- Repository: https://github.com/TestOptim-AI/testoptim-mcp
- Page: https://hostedmcp.org/servers/testoptim-ai/testoptim-mcp
- Transport: remote
- Stars: 0
- License: MIT
- Latest version: 1.0.0

## Install

### Claude Code

```sh
claude mcp add --transport http testoptim-mcp https://api.testoptim.com/api/mcp
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "testoptim-mcp": {
      "url": "https://api.testoptim.com/api/mcp"
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "testoptim-mcp": {
      "type": "http",
      "url": "https://api.testoptim.com/api/mcp"
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"testoptim-mcp","type":"http","url":"https://api.testoptim.com/api/mcp"}'
```

### Codex

```sh
codex mcp add testoptim-mcp --url https://api.testoptim.com/api/mcp
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.testoptim-mcp]
url = "https://api.testoptim.com/api/mcp"
```

### Gemini CLI

```sh
gemini mcp add -s user --transport http testoptim-mcp https://api.testoptim.com/api/mcp
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "testoptim-mcp": {
      "url": "https://api.testoptim.com/api/mcp",
      "type": "http"
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `TESTOPTIM_TOKEN` | no | no |  |

## Tools (8)

- `list_projects`
- `start_test_run`
- `get_test_run`
- `stop_test_run`
- `list_issues`
- `get_issue`
- `start_exploration`
- `get_exploration`

## FAQ

### How do I authenticate with TestOptim?

You use a TestOptim API key sent as a Bearer token in the Authorization header.

### Can I run tests on specific parts of my application?

Yes, you can pass changedAreas to the start_test_run tool to re-test only specific pages or flows.

### What information is included in a bug report?

The tool provides a full description, steps to reproduce, expected and actual behavior, the page URL, and a screenshot.

### Does the server require installation?

No, TestOptim hosts the server, so there is nothing for the user to install or run locally.
