TestOptim MCP server

Connect Claude Code, Cursor, VS Code and other MCP clients to TestOptim, so your AI assistant can run QA tests on your web app and read the issues they find.

“Run the QA suite on my project and show me the critical issues.”

TestOptim hosts the server; there is nothing to install or run. This repository holds the setup instructions, ready-to-copy client configs, and the server.json that lists the server in MCP registries.

• Endpoint: https://api.testoptim.com/api/mcp
• Transport: Streamable HTTP (stateless; POST only)
• Auth: a TestOptim API key, sent as Authorization: Bearer topt_...

Contents

• Before you start
• Create an API key
• Connect your client
• Agent skill and Claude Code plugin
• Tools
• Example prompts
• Security
• Limits and errors
• Troubleshooting

Before you start

• A TestOptim account with at least one project that has generated test cases. See Generate test cases.
• The Owner or Admin role in your organization, to create API keys.
• Runs started over MCP use your plan’s test executions, the same as runs started in the app. They are attributed to the person who created the key.

Create an API key

1. In TestOptim, open Settings, then API keys, and select New token.
2. Give it a name you will recognise, such as Claude Code - laptop.
3. Under Project access, choose All projects or a single project. A single project limits what a leaked key can reach.
4. Keep only the permissions you need (see Tools for which tool needs which).
5. Copy the token. It starts with topt_ and is shown once.

Then export it in the shell your client starts from, so it never lands in a config file:

export TESTOPTIM_TOKEN="topt_..."

The full guide, with screenshots, is Run TestOptim tests from CI with an API key.

To run tests from a GitHub Actions workflow instead, use TestOptim Run Tests.

Connect your client

Each snippet is also in examples/.

Claude Code

claude mcp add --transport http testoptim https://api.testoptim.com/api/mcp \
  --header "Authorization: Bearer ${TESTOPTIM_TOKEN}"

This stores the token in your local Claude Code config. Add --scope user to use it in every project.