About testkube-mcp
testkube-mcp connects AI assistants to Testkube's test platform for managing automated testing in Kubernetes. It exposes test workflows, executions, and artifacts for testing and troubleshooting tasks.
Key features
- 01Run automated tests in Kubernetes
- 02Trigger tests manually or from pipelines
- 03Aggregate results, logs, and artifacts
- 04Use existing testing tools and scripts
- 05Support centralized test troubleshooting
Use cases
- 01Starting a test workflow from an AI assistant
- 02Reviewing execution results and artifacts
- 03Investigating test failures using logs
- 04Running tests from CI/CD or Kubernetes events
MCP support
The MCP server lets AI assistants interact with Testkube. It provides access to test workflows, executions, and artifacts.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://api.testkube.io/organizations/{organization_id}/environments/{environment_id}/mcpclaude mcp add --transport http kubeshop-testkube https://api.testkube.io/organizations/{organization_id}/environments/{environment_id}/mcp{"mcpServers":{"kubeshop-testkube":{"type":"http","url":"https://api.testkube.io/organizations/{organization_id}/environments/{environment_id}/mcp"}}}Open in Cursor{"servers":{"kubeshop-testkube":{"type":"http","url":"https://api.testkube.io/organizations/{organization_id}/environments/{environment_id}/mcp"}}}Open in VS Code{"mcpServers":{"kubeshop-testkube":{"type":"http","url":"https://api.testkube.io/organizations/{organization_id}/environments/{environment_id}/mcp"}}}{"mcpServers":{"kubeshop-testkube":{"serverUrl":"https://api.testkube.io/organizations/{organization_id}/environments/{environment_id}/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
Details
From the project README
The Open Testing Platform for AI-driven Engineering Teams
Testkube provides a single platform for defining, running and analyzing automated tests, using your existing testing tools/scripts, running in your Kubernetes infrastructure.
Trusted by Engineering Teams at CoreWeave, NVidia, Siemens, T-Mobile, Harvard, SwissCom, and many more..
Website | Docs | Changelog | Blog | Slack | LinkedIn | X
Why Testkube?
- Run any Tests : Execute any tests/tools/scripts at scale; API, E2E, Performance, Security, Infrastructure, etc. - Examples & Guides.
- Trigger Tests whenever needed: Trigger tests manually, on schedules, from CI/CD/GitOps pipelines, on Kubernetes Events, via the REST API, through MCP, etc. - Read More.
- See Everything: All test results, artifacts, logs and resource-metrics are aggregated for centralized troubleshooting and reporting - Read More.
- Integrate Natively: Testkube integrates with existing tools and infrastructure using Webhooks, the Testkube REST API or the MCP Server - see Integration Examples.
- Testkube AI: Use the Testkube MCP Server or native AI Agents for troubleshooting, analysis, remediation, etc - Read More
- Enterprise Ready: SSO/SCIM, RBAC, Teams, Resource-Groups, Audit-logs, etc. - Read More.
See it in action: Open the interactive TestWorkflows showcase to see how a workflow builds up from a single test to a fully orchestrated pipeline.
Two ways to run Testkube
Open Source Agent - this repo.
MIT-licensed, runs standalone in your Kubernetes cluster, no control plane required. Great for single-cluster setups, self-managed environments, and evaluating Testkube.
- The Helm or CLI Installation will make it easy to deploy the agent into your target cluster.
- The Quickstart is the easiest way to set up Testkube and run your first tests.
Check out the Testkube Open Source Overview to learn more about the open source deployment architecture.
Commercial Control Plane
The control plane connects every Testkube agent across clusters, teams, and environments into a single dashboard:
- One control plane, unlimited clusters - orchestrate and analyze tests across clusters and regions
- Testkube AI - workflow generation, failure investigation, remediation PRs
- Enterprise-grade - SSO/SCIM, RBAC, audit logs, SLA-backed support
Check out the Installation Overview to learn more about different ways to deploy and run the Testkube Control Plane.
The online Trial is the easiest way to try the commercial Testkube offering - Get Started
Marketplace
The Testkube Marketplace provides an open and ready-to-use catalog of Testkube Workflows for Infrastructure Testing - Read More.
Documentation
Extensive documentation is available at docs.testkube.io.
Contributing
Check out our Contributors Guide and the Agent Architecture to find your way around our codebase and process.
If you want to contribute code, this reading order works well:
- CONTRIBUTING.md - contribution workflow, coding standards, and PR process
- DEVELOPMENT.md - local setup with Tilt and day-to-day development loop
- ARCHITECTURE.md - high-level system design and key code paths
Shout-out to our contributors 🎉 - you're great!
- ⭐️ @lreimer - K6 executor Gradle executor Maven executor
- ⭐️ @jdborneman-terminus - Ginkgo executor
- ️⭐️ @abhishek9686
- ⭐️ @ancosma
- ⭐️ @Stupremee
- ⭐️ @artem-zherdiev-ingio
- ⭐️ @chooco13 - Playwright executor
Go to contribution document to read more how can you help us 🔥
Feedback
Whether Testkube helps you or not, we would love to help and hear from you. Please join us on Slack to ask questions and let us know how we can make Testkube even better!
Comments
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.