mcpField
T
Tesults MCP

Tesults MCP

Local
github.com/tesultsDeveloper Tools0Updated 2w ago
Repository

About Tesults MCP

Tesults MCP is an MCP server for AI agents and MCP-compatible tools to inspect Tesults test results, targets, and insights. It includes a reporting-only mode that limits available operations to reporting and analysis.

Key features

  1. 01Inspect test results and targets
  2. 02Retrieve test insights
  3. 03Reporting-only mode
  4. 04Create, edit, and delete targets
  5. 05Regenerate tokens

Use cases

  1. 01Investigate test failures and regressions
  2. 02Review test runs through an AI agent
  3. 03Restrict an instance to reporting operations

MCP support

It exposes Tesults results, insights, and target operations as tools for MCP clients. Setting `TESULTS_READ_ONLY=true` limits the server to reporting and insight tools and blocks non-GET requests locally.

#testing#test-automation#playwright#jest#pytest#cypress#ci-cd#reporting#developer-tools

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "tesults": {
      "command": "npx",
      "args": [
        "-y",
        "tesults-mcp"
      ],
      "env": {
        "TESULTS_API_TOKEN": "<TESULTS_API_TOKEN>",
        "TESULTS_READ_ONLY": "<TESULTS_READ_ONLY>"
      }
    }
  }
}
Run commandnpx -y tesults-mcp
Environment variables to set
TESULTS_API_TOKENSecretTesults API token - obtain from your Tesults project configuration
TESULTS_READ_ONLYSet to true for reporting-only mode: only the reporting and insight tools are exposed and non-GET API requests are blocked locally

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmtesults-mcp1.1.0

Tools

11

Saved tool list · updated 2w ago

ParameterTypeRequiredDescription
limitstringNoMaximum number of targets to return
cursorstringNoPagination cursor from a previous response

Details

From the project README

tesults-mcp

Tesults MCP server. Connect AI agents and MCP-compatible tools to your Tesults test results, insights, and targets.

Documentation

Full setup and usage documentation: https://www.tesults.com/docs/api/mcp

Quick start

claude mcp add tesults-mcp npx tesults-mcp -e TESULTS_API_TOKEN=your-api-token

Reporting-only mode

Set TESULTS_READ_ONLY=true in the MCP server's environment alongside TESULTS_API_TOKEN. This exposes only the seven reporting and insight tools. Target creation, editing, deletion and token regeneration are not registered, and non-GET API requests are blocked locally.

Existing configurations remain unchanged when this setting is omitted or false. This is a restriction in this MCP server, not a reduction in the API token's permissions. Keep the token private. Insight tools can still generate and cache AI analyses on the server; they do not change your test results or targets.

Requests time out after 60 seconds and responses are limited to 10 MiB. For large result sets, request fewer runs or use cases=false for summaries. API failures are returned as tool errors, not successful answers.

These options apply to this source version and require an updated installation once released. They do not change an already installed published package.

Offline checks

Run node --test tests/hardening.test.js. Tests do not call Tesults or use a real token.

License

MIT

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.