Testkube MCP

Get execution metrics for a workflow: execution statistics, health scores, pass rates, and performance data. Use to analyze workflow reliability over time.

Analyze resource consumption patterns (CPU, memory, disk, network) across recent executions of a workflow. Computes cross-execution statistics (mean, min, max, stdDev), detects trends, and identifies outliers. Use to investigate growing resource usage or find abnormal runs. Requires workflowName.

Get the YAML schema for TestWorkflow definitions. Returns all available fields, their types, and descriptions. Use to understand workflow structure when creating or querying workflows.

Get the YAML definition of a specific TestWorkflowTemplate. Returns the complete template specification including steps, config schema, and metadata.

List available agents in the organization for workflow execution targeting. Returns agent names, types, capabilities, labels, and status. Use before run_workflow to discover target agents.

List all artifacts (files, reports, logs) generated by a workflow execution. Returns artifact names, sizes, and status. Use to discover available outputs before reading specific artifacts.

Description is built at runtime.

List test workflow executions with filtering by workflow, status, date range, labels, tags, or text search. Returns execution summaries including status, duration, and metadata. Use to discover recent runs or find specific executions.

List the workflow executions that produced a given insight metric, most recent first. Use after get_insight_metric_series to drill from a metric value/trend down to the concrete executions behind it, then pivot to get_execution_info or fetch_execution_logs. Filter with the same 'measure'/identity/workflow/status/tag/date filters as get_insight_metric_series. Scoped to the current environment.

List the distinct granular insight metric keys available (e.g. 'http_req_duration_p95_ms', 'response_time_percentile_2_ms', 'test_duration_ms'). A lightweight vocabulary for discovery; use list_insight_series when you also need seriesId, source, workflow or identity. Scoped to the current environment.

Discover the granular insight metric series ingested from test/performance reports. Each series is one metric for one workflow (and optional identity, e.g. a specific k6 request name or JUnit test case), identified by a seriesId. Series are parsed from k6, jmeter, artillery, junit and influx reports. Use this to find which metrics exist and to get the seriesId and metricKey to feed into get_insight_metric_series. Scoped to the current environment.

List all workflow labels and their values in the environment. Use to discover available filters for selector parameters in other tools.

List available resource groups in the organization. Use to discover group slugs for filtering workflows and executions.

List Testkube workflows with optional filtering by resource group, selector, status, and text search. Returns workflow names, descriptions, and execution status.

List all TestWorkflowTemplates with optional label filtering. Returns template names, descriptions, and labels.

Resolve an execution name (e.g., 'my-workflow-123') to its execution ID. Use when you have an execution name but need the ID for other tools.

Query execution records across multiple workflows using JSONPath. Fetches execution data and extracts fields matching the expression. Use for cross-workflow analysis: find all failed executions, compare durations, or extract specific fields in bulk.

Query workflow definitions in bulk using JSONPath. Fetches workflow YAML and extracts fields matching the expression. Use to find workflows by configuration patterns, image references, or step structure across all workflows.

Read content from an artifact file produced by a workflow execution. Default returns first 100 lines (max 200 per request). Always paginate in 100-200 line chunks. For binary artifacts, returns a summary instead of content.

Description is built at runtime.

Description is built at runtime.

Run a TestWorkflow with optional configuration parameters and agent targeting. Use get_workflow_definition first to discover available config parameters. Use list_agents to discover available target agents.

Description is built at runtime.

Description is built at runtime.

Update tags on a workflow execution. Uses replace semantics: provided tags completely replace existing tags. Send empty map {} to clear all tags. Tags are key-value pairs for categorization and filtering.

Update an existing TestWorkflow with a new YAML definition. The workflow is updated immediately and available for execution with the new configuration.

Update an existing TestWorkflowTemplate with a new YAML definition. Workflows using the template pick up the changes.

Wait for a list of workflow executions to complete. Returns the final status of all executions. Use for synchronizing dependent workflows.