← Back to directory
T

Testkube MCP Server

Official
MCP server for the open testing platform built for AI-driven engineering teams
GitHub source repository ↗
★ 1.7k Stars Category · Dev Tools Very popular
63FMRS · C

Testkube MCP Server is Testkube's official MCP entry point for AI-driven engineering teams running automated tests on Kubernetes, covering test workflows, executions, and artifacts. It supports both a locally run OCI image over stdio and a hosted streamable-http remote endpoint, gated by a Testkube access token plus organization and environment credentials, with documentation at https://docs.testkube.io/articles/mcp-overview. The source does not enumerate individual tools, so the tool list is empty.

Reliability
9/20
Security and permissions
13/20
Maintenance
15/20
Documentation
13/20
Setup experience
13/20
Read the FMRS scoring method →

Testkube MCP Server is maintained by Testkube and lets AI assistants manage Testkube test workflows, executions, and artifacts. It is available in two forms: a locally run OCI image, docker.io/kubeshop/mcp-server:latest, using stdio transport, and a hosted streamable-http remote at https://api.testkube.io/organizations/{organization_id}/environments/{environment_id}/mcp. The remote endpoint requires organization_id (for example tkcorg_xxxxxxx) and environment_id (for example tkcenv_xxxxxxx). The local image requires TK_ACCESS_TOKEN, TK_ORG_ID, and TK_ENV_ID, with optional TK_CONTROL_PLANE_URL, TK_DASHBOARD_URL, TK_DEBUG, TK_MCP_TRANSPORT, TK_MCP_SHTTP_HOST, and TK_MCP_SHTTP_PORT. It suits teams running automated tests on Kubernetes that want to trigger tests, inspect results and artifacts, and troubleshoot from an AI assistant. It is not suitable for users without a Testkube organization/environment or those unwilling to give an AI client access to a test access token.

Setup

  1. Obtain a Testkube access token, organization ID (tkcorg_xxxxxxx), and environment ID (tkcenv_xxxxxxx) from Testkube.
  2. For local stdio: configure your MCP client to run the OCI image docker.io/kubeshop/mcp-server:latest and set the required environment variables TK_ACCESS_TOKEN, TK_ORG_ID, and TK_ENV_ID; optionally set TK_CONTROL_PLANE_URL (default https://api.testkube.io), TK_DASHBOARD_URL, TK_DEBUG, TK_MCP_TRANSPORT (stdio or shttp, default stdio), TK_MCP_SHTTP_HOST, and TK_MCP_SHTTP_PORT.
  3. For the remote option: connect your client to the streamable-http endpoint https://api.testkube.io/organizations/{organization_id}/environments/{environment_id}/mcp, substituting your real organization and environment IDs.
  4. Consult the official documentation at https://docs.testkube.io/articles/mcp-overview for client-specific configuration details.

Fit and risk

Best for

  • Engineering teams already running Testkube on Kubernetes for automated testing
  • Platform and DevOps teams that want to manage test workflows and executions with AI assistants
  • Organizations looking to fold test result inspection and troubleshooting into AI workflows

Not for

  • Users who have not deployed Testkube or lack organization/environment credentials
  • Teams unwilling to expose a test access token to an AI client
  • General-purpose testing scenarios unrelated to Testkube or non-Kubernetes testing

Required permissions

  • Read and use the Testkube access token (TK_ACCESS_TOKEN) for authentication
  • Access test workflows, executions, and artifacts within the specified Testkube organization and environment
  • Remote mode requires network access to https://api.testkube.io and the organization/environment path

Risks and side effects

  • The access token is a sensitive credential; leaking it could let others read or act on test data in the target organization/environment
  • AI assistants may trigger or affect real test executions and the Kubernetes test resources they consume
  • The remote streamable-http mode sends requests and credentials to the Testkube cloud control plane
  • Overly broad token permissions or wrong organization/environment IDs could reach unintended environments

Troubleshooting

  1. Verify that TK_ACCESS_TOKEN, TK_ORG_ID, and TK_ENV_ID are set correctly and are not empty
  2. Confirm organization_id and environment_id match the values in Testkube (tkcorg_ and tkcenv_ prefixes)
  3. For remote mode, check network access to https://api.testkube.io; for local mode, check the control plane URL (default https://api.testkube.io)
  4. Enable TK_DEBUG for more detailed debug output
  5. When using the shttp transport, verify TK_MCP_TRANSPORT, TK_MCP_SHTTP_HOST, and TK_MCP_SHTTP_PORT

Use cases

Trigger and monitor Testkube test workflow executions from an AI assistant
Query test execution results, logs, and artifacts for centralized troubleshooting
Integrate test orchestration into AI-driven engineering workflows on Kubernetes
Provide a natural-language entry point to test results in CI/CD and GitOps setups

Supported clients

Claude DesktopPartial support