Katalon True Platform MCP

Start here · Quickstart · Skills · Lifecycle · Install · MCP · Contributing

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.

An example session. Your requirement keys, suites, and verdicts come from your own workspace.

Quickstart

1. Install the skills. The skills CLI detects the agent you already run (70+ supported) and drops the skills into its native directory.

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 says which file yours is):

{

"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.

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.

| 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 → test-data → execute-test → analyze-failures Unscripted session? exploratory-charter. | | 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 → playwright-execute → test-maintenance | | 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 → test-estimation → test-review → test-management | | 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 → test-estimation → test-reporting |

Not connected yet? Start at platform-setup, which everyone runs once.

Not sure which one you are, or the request spans several? Ask true-platform-testing 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.

The skills

Nineteen skills, one folder each under skills/. The agent picks the right one from its description, so you rarely name a skill yourself.

Multi-skill playbooks live in combination-recipes.md. Copy-paste prompts and cross-model notes are in 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.

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. Every tool in one line each: mcp-tool-index.md. A self-contained visual for humans: 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.

Install

Every path needs the Katalon MCP configured.

Any agent via the skills CLI

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 Ag