# Katalon True Platform MCP [Health: Active] **Category:** 💻 Developer Tools **Repository:** https://github.com/katalon-labs/true-skills **GitHub Stars:** 7 **Views:** 0 **Installs:** 0 **Upvotes:** 0 **Directory Page:** https://allmcps.com/mcp/katalon-true-platform-mcp ## Description Katalon True Platform MCP: design tests, run with AI, upload reports, assess release readiness. ## Claude Desktop Quick Installation Install path detected from listing signals. Uses `npx` (confidence: high): ```json "mcpServers": { "katalon-true-platform-mcp": { "command": "npx", "args": ["-y","skills"] } } ``` ## Documentation & README
True Skills: testing skills for agents, for Katalon True Platform, in the AI coding agent you already use [![License: MIT](https://img.shields.io/badge/license-MIT-0f8461?style=flat-square)](LICENSE) ![18 skills](https://img.shields.io/badge/skills-18-0f8461?style=flat-square) ![8 agents](https://img.shields.io/badge/agents-8%20+%20AGENTS.md-0f8461?style=flat-square) ![Katalon MCP](https://img.shields.io/badge/runs%20on-Katalon%20MCP-0f8461?style=flat-square) [Start here](#start-where-you-are) · [Quickstart](#quickstart) · [Skills](#the-skills) · [Lifecycle](#the-lifecycle) · [Install](#install) · [MCP](#connect-the-katalon-mcp) · [Contributing](https://github.com/katalon-labs/true-skills/blob/HEAD/CONTRIBUTING.md)
Ask your coding agent to read a requirement, design the test cases, run them with AI, upload the reports, and tell you whether the release is safe to ship. The skills do the platform work through the Katalon MCP, so the agent operates your real project instead of guessing at it. Example agent session: install the skills, analyze requirement CEL-6, design and import cases, run with AI, upload the report, and get a ship decision An example session. Your requirement keys, suites, and verdicts come from your own workspace. ## Quickstart **1. Install the skills.** The [`skills` CLI](https://github.com/vercel-labs/skills) detects the agent you already run (70+ supported) and drops the skills into its native directory. ```bash npx skills add katalon-labs/true-skills ``` **2. Point it at your Katalon workspace.** Add the MCP server to your agent's config file (the [install section](#install) says which file yours is): ```json { "mcpServers": { "katalon-prod-mcp": { "type": "http", "url": "https://platform.katalon.io/mcp" } } } ``` First connect opens a browser OAuth flow and lets you pick your workspace. Nothing to fill in, no tokens to paste, no keys to store. **3. Ask for something real.** ```text Set up Katalon MCP and verify my projects. Create manual tests from requirement CEL-6 and link them. Which requirements in this sprint have no test coverage? Run that suite with AI and summarize what broke. Generate a Playwright script from test case TC-1042. Upload my Playwright report to Katalon and verify the run. Is release 3.2 safe to ship? ``` Or hand over the whole chain: *"Analyze CEL-6, design and import the cases, build a suite, run it with AI, and tell me if we can ship."* ## Start where you are Four jobs. Say the situation in your own words and the agent picks the skill. | You are a | You say | It starts at | | --- | --- | --- | | **Manual tester**
QA analyst, test analyst | *I just got requirement CEL-6 and need cases* · *Run this suite with AI and tell me what broke* · *Is this failure the app or my test* | [`create-test-cases`](https://github.com/katalon-labs/true-skills/blob/HEAD/skills/create-test-cases/SKILL.md) → [`test-data`](https://github.com/katalon-labs/true-skills/blob/HEAD/skills/test-data/SKILL.md) → [`execute-test`](https://github.com/katalon-labs/true-skills/blob/HEAD/skills/execute-test/SKILL.md) → [`analyze-failures`](https://github.com/katalon-labs/true-skills/blob/HEAD/skills/analyze-failures/SKILL.md)
Unscripted session? [`exploratory-charter`](https://github.com/katalon-labs/true-skills/blob/HEAD/skills/exploratory-charter/SKILL.md). | | **Automation tester**
SDET, automation engineer | *Turn TC-1042 into a Playwright spec* · *Get my run into the platform* · *Our suite went flaky this month* | [`test-case-to-playwright`](https://github.com/katalon-labs/true-skills/blob/HEAD/skills/test-case-to-playwright/SKILL.md) → [`playwright-execute`](https://github.com/katalon-labs/true-skills/blob/HEAD/skills/playwright-execute/SKILL.md) → [`test-maintenance`](https://github.com/katalon-labs/true-skills/blob/HEAD/skills/test-maintenance/SKILL.md) | | **Test lead**
QA lead, QE lead | *What should we test first this sprint* · *Is this suite ready for the pipeline* · *Which requirements have no coverage* | [`test-plan`](https://github.com/katalon-labs/true-skills/blob/HEAD/skills/test-plan/SKILL.md) → [`test-estimation`](https://github.com/katalon-labs/true-skills/blob/HEAD/skills/test-estimation/SKILL.md) → [`test-review`](https://github.com/katalon-labs/true-skills/blob/HEAD/skills/test-review/SKILL.md) → [`test-management`](https://github.com/katalon-labs/true-skills/blob/HEAD/skills/test-management/SKILL.md) | | **Test manager**
QA manager, head of quality | *Can we ship 3.2* · *How long will this take and with how many people* · *Build the summary I present upward* | [`release-analyze`](https://github.com/katalon-labs/true-skills/blob/HEAD/skills/release-analyze/SKILL.md) → [`test-estimation`](https://github.com/katalon-labs/true-skills/blob/HEAD/skills/test-estimation/SKILL.md) → [`test-reporting`](https://github.com/katalon-labs/true-skills/blob/HEAD/skills/test-reporting/SKILL.md) | Not connected yet? Start at [`platform-setup`](https://github.com/katalon-labs/true-skills/blob/HEAD/skills/platform-setup/SKILL.md), which everyone runs once. Not sure which one you are, or the request spans several? Ask [`true-platform-testing`](https://github.com/katalon-labs/true-skills/blob/HEAD/skills/true-platform-testing/SKILL.md) and it routes by role and by stage. The full map from intent to skill, including what to fall back to for the parts not built yet, is in [`lifecycle-map.md`](https://github.com/katalon-labs/true-skills/blob/HEAD/skills/true-platform-testing/references/lifecycle-map.md). ## The skills Eighteen skills, one folder each under [`skills/`](https://github.com/katalon-labs/true-skills/blob/HEAD/skills/). The agent picks the right one from its description, so you rarely name a skill yourself. | Skill | Stage | What it does | | --- | --- | --- | | [platform-setup](https://github.com/katalon-labs/true-skills/blob/HEAD/skills/platform-setup/SKILL.md) | setup | Installs and verifies the Katalon MCP, and diagnoses auth or access failures. Start here. | | [test-plan](https://github.com/katalon-labs/true-skills/blob/HEAD/skills/test-plan/SKILL.md) | 1 plan | Turns quality goals into scope, ranks the work by requirement coverage and risk, and builds the folder and suite structure that acts as the executable plan. | | [test-estimation](https://github.com/katalon-labs/true-skills/blob/HEAD/skills/test-estimation/SKILL.md) | 1 plan | Sizes a test cycle from scope, risk, and historical execution data, resources it across the manual and automated lanes, and states the uncertainty instead of inventing precision. | | [create-test-cases](https://github.com/katalon-labs/true-skills/blob/HEAD/skills/create-test-cases/SKILL.md) | 2 design | Reads a requirement or free text, designs atomic manual cases with ISTQB techniques as reference, skips duplicates, imports only what is missing, and links each case back to the requirement. | | [test-data](https://github.com/katalon-labs/true-skills/blob/HEAD/skills/test-data/SKILL.md) | 2 design | Designs the data a case runs on, decides what must exist before a run, keeps literals out of the step text, and resets state afterwards so the next run starts clean. | | [exploratory-charter](https://github.com/katalon-labs/true-skills/blob/HEAD/skills/exploratory-charter/SKILL.md) | 2 design | Writes a charter with a mission, areas, oracles, and a timebox, runs the session, and turns what was found into defects and scripted cases. | | [test-management](https://github.com/katalon-labs/true-skills/blob/HEAD/skills/test-management/SKILL.md) | 3 manage | Organizes folders and suites, finds assets at scale, and produces a requirement to case to suite traceability report with coverage percentage and orphans. | | [test-review](https://github.com/katalon-labs/true-skills/blob/HEAD/skills/test-review/SKILL.md) | 4 review | Reviews coverage, case quality, and flakiness before anything enters the pipeline, and returns Approve, Approve with fixes, or Reject plus the specific weak cases. | | [execute-test](https://github.com/katalon-labs/true-skills/blob/HEAD/skills/execute-test/SKILL.md) | 5 execute | Runs a case, a list, or a suite as a manual run, a Run with AI session, or scheduled automation, then reports pass, fail, and blocked. | | [upload-report](https://github.com/katalon-labs/true-skills/blob/HEAD/skills/upload-report/SKILL.md) | 5 execute | Runs automation and uploads or verifies Katalon Studio/KRE, JUnit XML, and Playwright reports on the platform. | | [test-case-to-playwright](https://github.com/katalon-labs/true-skills/blob/HEAD/skills/test-case-to-playwright/SKILL.md) | 5 execute | Converts manual cases into Playwright TypeScript with Page Object Model and fixtures. | | [test-case-to-katalon-studio](https://github.com/katalon-labs/true-skills/blob/HEAD/skills/test-case-to-katalon-studio/SKILL.md) | 5 execute | Converts manual cases into Katalon Studio test cases and Groovy scripts, keeping the .tc and .ts pair GUID-consistent. | | [playwright-execute](https://github.com/katalon-labs/true-skills/blob/HEAD/skills/playwright-execute/SKILL.md) | 5 execute | Runs Playwright specs, ships the report with `@katalon/playwright-reporter`, and verifies the run landed. | | [analyze-failures](https://github.com/katalon-labs/true-skills/blob/HEAD/skills/analyze-failures/SKILL.md) | 6 analyze | Sorts failures into product defect, automation defect, and environment noise, clusters them by signature, and files ALM defects for the real bugs. | | [release-analyze](https://github.com/katalon-labs/true-skills/blob/HEAD/skills/release-analyze/SKILL.md) | 6 analyze | Reads coverage, stability, and defect data to return Ready, Ready with risk, or Not ready, with the reasons attached. | | [test-reporting](https://github.com/katalon-labs/true-skills/blob/HEAD/skills/test-reporting/SKILL.md) | 6 analyze | Turns platform quality data into the few metrics that answer a stakeholder question, trended across releases, as a summary a manager can present upward. | | [test-maintenance](https://github.com/katalon-labs/true-skills/blob/HEAD/skills/test-maintenance/SKILL.md) | 7 maintain | Finds flaky and broken cases from stability history, repairs or regenerates them, and hands the refreshed gap list back to planning. | | [true-platform-testing](https://github.com/katalon-labs/true-skills/blob/HEAD/skills/true-platform-testing/SKILL.md) | all | The router and end to end runner. Routes any request to the right stage, or drives the full chain from requirement to ship decision. | Multi-skill playbooks live in [`combination-recipes.md`](https://github.com/katalon-labs/true-skills/blob/HEAD/skills/true-platform-testing/references/combination-recipes.md). Copy-paste prompts and cross-model notes are in [`prompt-recipes.md`](https://github.com/katalon-labs/true-skills/blob/HEAD/skills/true-platform-testing/references/prompt-recipes.md). ## The lifecycle Seven stages, each owned by a skill. The loop closes when maintenance feeds its gap list back into the plan. The seven-stage testing lifecycle and the skill that owns each stage, with the maintenance gap list feeding back into planning `platform-setup` sits before all seven, connecting the MCP. Every skill states which Katalon MCP tools it uses and where the platform stops. Full stage map: [`lifecycle-map.md`](https://github.com/katalon-labs/true-skills/blob/HEAD/skills/true-platform-testing/references/lifecycle-map.md). Every tool in one line each: [`mcp-tool-index.md`](https://github.com/katalon-labs/true-skills/blob/HEAD/skills/true-platform-testing/references/mcp-tool-index.md). A self-contained visual for humans: [`docs/lifecycle.html`](https://github.com/katalon-labs/true-skills/blob/HEAD/docs/lifecycle.html). ## Where the boundary is Each skill names its limits up front so the agent does not promise work the platform cannot do. **Through the MCP:** list projects and repositories, read requirements, create and update and link test cases, manage suites and folders, create manual runs, start Run with AI, poll AI sessions, read results, fetch quality metrics, and file ALM-linked defects. **Not through the MCP:** creating requirements, creating a formal Test Plan entity, guaranteeing an AI run finishes, or inspecting the live app UI without a browser tool. A named suite plus a release or sprint association stands in for the Test Plan entity. Some work is a product surface rather than an API call: object capture and resilience design in Studio, custom fields and Git config and governance in the TestOps UI, self-healing and Time Capsule and TrueTest regeneration, and rerun, terminate, and Live Monitor. The full list is in [`unavailable-capabilities.md`](https://github.com/katalon-labs/true-skills/blob/HEAD/skills/true-platform-testing/references/unavailable-capabilities.md). ## Install Every path needs the [Katalon MCP](#connect-the-katalon-mcp) configured.
Any agent via the skills CLI ```bash npx skills add katalon-labs/true-skills # all skills, this project npx skills add katalon-labs/true-skills --skill platform-setup # just one npx skills add katalon-labs/true-skills -g # user-global, every agent npx skills update # pull the latest ``` The CLI installs skill files only. Configure the MCP yourself with the snippet below, or use the Claude Code and Codex plugin paths, which bundle it.
Any agent via the Agent Plugins standard This repository conforms to the [Agent Plugins specification 1.0.0](https://agent-plugins.org/specification): `plugin.json` + `skills/` + `mcp.json` at the repo root form a portable plugin any conformant client can load directly, and `plugins/katalon-true-platform/` ships the same contract as a standalone plugin directory. Skills follow the [Agent Skills](https://agentskills.io) format. Point your standard-aware client at either directory; `mcp.json` already declares the canonical endpoint as a `streamable-http` server, so there is nothing to fill in.
Claude Code plugin marketplace ```bash claude plugin marketplace add katalon-labs/true-skills claude plugin install katalon-true-platform@katalon-true-platform-marketplace ``` Developing against a checkout: ```bash claude --plugin-dir plugins/katalon-true-platform ``` The plugin ships the skills and an `.mcp.json`. If your setup does not auto-load the bundled MCP, add it manually.
Codex plugin marketplace ```bash codex plugin marketplace add katalon-labs/true-skills ``` Open **Plugins** in Codex and install **Katalon True Platform**. Set your subdomain in the plugin's `.mcp.json`.
GitHub Copilot agent skills + MCP ```bash mkdir -p .github .vscode \ && cp -R /.github/skills .github/ \ && cp -R /.github/prompts .github/ \ && cp /.github/copilot-instructions.md .github/ \ && cp /.github/mcp.json .github/ \ && cp /.vscode/mcp.json .vscode/ ``` - **VS Code (agent mode)** - skills in `.github/skills/` load automatically; prompt files stay available as `/platform-setup` etc. Start the `katalon-prod-mcp` server when VS Code offers it: it signs you in through the browser OAuth flow and you pick your workspace. Nothing to configure, no token pasting. - **Copilot CLI** - the same skills are auto-discovered (`/skills list` to see them). The MCP server auto-loads from `.github/mcp.json` with no edits; or register it interactively with `/mcp add` (type `http`, same URL). The CLI does not read `.vscode/mcp.json`. - **Copilot coding agent & code review** - read `.github/skills/` from your repository automatically. Neither surface supports OAuth remote MCP servers yet, so keep Katalon platform operations in VS Code or the CLI for now.
Cursor project rules ```bash cp -R /.cursor .cursor ``` Rules in `.cursor/rules/*.mdc` load by description when relevant. MCP config lives in `.cursor/mcp.json`.
Kiro steering docs ```bash cp -R /.kiro .kiro ``` Steering docs use manual inclusion, so reference one in chat with `#true-platform-testing`. MCP config lives in `.kiro/settings/mcp.json`.
Kiro Crew app [Kiro Crew](https://kirocrew.com) installs this as an **app** — `apps/katalon-testing-skills/` carries an `app.json` manifest that registers all 18 skills and the `katalon-prod-mcp` server on install. From the dashboard's **Apps** page, install from the local path, or submit the repo to the Kiro Crew app registry so it appears under **Apps → Discover**. First MCP connect opens the browser OAuth flow and a workspace picker. ```bash # local/developer install: point Kiro Crew at the app directory apps/katalon-testing-skills/ ``` Details in [`apps/katalon-testing-skills/README.md`](https://github.com/katalon-labs/true-skills/blob/HEAD/apps/katalon-testing-skills/README.md).
Windsurf rules ```bash cp -R /.windsurf .windsurf ``` Rules in `.windsurf/rules/*.md` trigger on their description. Add the MCP under **Settings → MCP**, or in `~/.codeium/windsurf/mcp_config.json`.
Cline project rules ```bash cp -R /.clinerules .clinerules ``` Cline loads every file in `.clinerules/`. Add the MCP through its **MCP Servers** panel.
Continue rules and MCP block ```bash cp -R /.continue .continue ``` Rules live in `.continue/rules/*.md`, the MCP block in `.continue/mcpServers/katalon.yaml`.
Anything else via AGENTS.md Point your agent at [`AGENTS.md`](https://github.com/katalon-labs/true-skills/blob/HEAD/AGENTS.md). It indexes every skill and tells the agent to open `skills//SKILL.md`. Use the root [`.mcp.json`](https://github.com/katalon-labs/true-skills/blob/HEAD/.mcp.json) for the server config.
## Connect the Katalon MCP One endpoint serves every workspace: `https://platform.katalon.io/mcp`. Sign-in presents a workspace picker, so there is no subdomain to look up. The canonical shape lives in [`.mcp.json`](https://github.com/katalon-labs/true-skills/blob/HEAD/.mcp.json): ```json { "mcpServers": { "katalon-prod-mcp": { "type": "http", "url": "https://platform.katalon.io/mcp" } } } ``` Agents without native remote-MCP support (Kiro, Continue, Codex) use the `mcp-remote` wrapper against the same endpoint: ```sh npx -y mcp-remote https://platform.katalon.io/mcp --transport http-first ``` 1. Complete the browser OAuth flow that opens on first connect. 2. Pick your workspace. 3. Reload the agent if the tools do not show up. On a dedicated Katalon domain, substitute `https://.katalon.io/mcp`. > **Auth is browser OAuth only.** Never paste passwords, API tokens, cookies, JWTs, MFA codes, or OAuth callback URLs into chat, and never commit them. The skills enforce this. ## How it is built The skill bodies live once. Everything each agent needs is generated from them, so no adapter can drift. ```text skills/ 13 SKILL.md files plus references/ | | node scripts/build-adapters.mjs deterministic, checked in CI v Claude Code · Codex · Copilot · Cursor · Kiro · Windsurf · Cline · Continue · AGENTS.md | | every adapter points at the same server v Katalon MCP -> requirements, test cases, suites, Run with AI, results, defects ``` ```text skills/ source of truth, 18 skills scripts/build-adapters.mjs generates every agent config plugins/katalon-true-platform/ Claude Code and Codex plugin (generated) .claude-plugin/ .agents/ plugin marketplaces (generated) .cursor/ .kiro/ .github/ Cursor, Kiro, Copilot (generated) .windsurf/ .clinerules/ .continue/ Windsurf, Cline, Continue (generated) apps/katalon-testing-skills/ Kiro Crew app (generated) .mcp.json .vscode/mcp.json MCP config (generated) AGENTS.md llms.txt agent-readable index (generated) ``` ## Contributing Edit `skills/` only. Everything else is generated. Then: ```bash node scripts/validate-skills.mjs # skills/ matches scripts/skills.config.mjs node scripts/build-adapters.mjs # regenerate every agent config ``` The build is deterministic. Re-running it with no skill changes produces no diff, and CI rejects out-of-sync adapters. Details in [CONTRIBUTING.md](https://github.com/katalon-labs/true-skills/blob/HEAD/CONTRIBUTING.md). ## Support - Bugs, questions, and skill requests: [open an issue](https://github.com/katalon-labs/true-skills/issues) - Katalon platform and MCP support: [support.katalon.com](https://support.katalon.com), or your Katalon Customer Success Manager - MCP server documentation: [docs.katalon.com](https://docs.katalon.com/katalon-platform/testops-mcp-server) ## Privacy The skills are plain markdown that runs inside the agent you already use. This repository collects nothing. Platform operations go to your own Katalon workspace over OAuth, and what Katalon does with that data is covered by the [Katalon Privacy Policy](https://katalon.com/terms#privacy-policy). ## License [MIT](https://github.com/katalon-labs/true-skills/blob/HEAD/LICENSE) © Katalon. "Katalon" and "Katalon True Platform" are trademarks of Katalon, Inc.