Testomat.io

Provides a Node.js MCP server to connect Testomat.io API with AI assistants, enabling queries for tests, suites, runs, and plans.

typescript

GitHub Stars

typescript

Language

6 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "mcp-mirror-testomatio_mcp": {
      "command": "npx",
      "args": [
        "@testomatio/mcp",
        "--token",
        "<your-token>",
        "--project",
        "<project-id>"
      ],
      "env": {
        "TESTOMATIO_BASE_URL": "https://app.testomat.io",
        "TESTOMATIO_API_TOKEN": "<your-token>"
      }
    }
  }
}

You run a Node.js MCP server that connects Testomat.io API data to AI assistants. It lets you securely query tests, suites, runs, and plans from Cursor or other MCP clients, unlocking conversational access to your test data with up-to-date results and filters.

How to use

Install and start the MCP server using the recommended npx command. Then configure your MCP client (for example Cursor) to point to this server with your API token and project ID. Once configured, you can ask your AI assistant to list tests, fetch runs, view root suites, or retrieve plans for your project.

How to install

Prerequisites: Node.js 18 or higher with built-in fetch support, and a package manager such as npm or yarn. You also need a Testomat.io account with API access.

Run directly with npx to start the MCP server:

npx @testomatio/mcp --token <your-token> --project <project-id>

Available tools

get_tests

Retrieve all tests with optional filters such as plan, query, state, suite_id, tag, or labels. Endpoint: GET /tests

search_tests

Search tests with query, tql, labels, state, priority, filter, or page parameters. Endpoint: GET /tests

get_root_suites

List root-level suites with no parameters. Endpoint: GET /suites

get_suite

Get details of a single suite by suite_id. Endpoint: GET /suites/{suite_id}

get_runs

List all test runs. Endpoint: GET /runs

get_run

Get details for a specific run by run_id and optional tree view. Endpoint: GET /runs/{run_id}

get_testruns

Retrieve runs for a specific test by test_id with an optional finished_at_date_range filter. Endpoint: GET /testruns

get_plans

List all test plans with detail, labels, or page filters. Endpoint: GET /plans

get_plan

Get a specific plan by plan_id. Endpoint: GET /plans/{plan_id}

Built by

VeilStrat

AI signals for GTM teams