Katalon built-in MCP servers

This document provides descriptions on Katalon's built-in MCP servers.

Katalon MCP Server

This server specializes in finding/returning Katalon's document.

Tool	Description
search_katalon_knowledge_base	Search Katalon's official documentation using semantic search to retrieve relevant text chunks about Katalon products, features, configurations, and troubleshooting.
read_katalon_documentation	Fetch and convert a Katalon documentation page to HTML format with configurable image processing.

Usage Tips

• Ask a question like "What's new in 10.4.0?" to quickly get the information you need.
• To get the full content of the documentation page, follow up with "Get me the full release notes".

Katalon Studio MCP Server

This server has the following tools, grouped by features:

Test Case tools

Tool	Description	Example Prompt
getTestCases	Get a list of all test case IDs in the current project	Get all test cases in this project.
createTestCase	Create a new test case under your specified folder with your provided details	Create new test case ‘example_test_case’ with description ‘Verify login page loads correctly.’
updateTestCase	Update test case with name, description, tags and comments you provide	Update test case ‘example_test_case’ — change the description to ‘Include password recovery step’ and add the tag ‘UI.’
getTestCaseScript	Get the Groovy script content and other metadata for a specific test case	Get test case script for the ‘example_test_case.’
updateTestCaseScript	Update the Groovy script content for an existing test case	Update test case script: add this step to ‘example_test_case’: WebUI.verifyElementPresent(findTestObject('Login/Button_Login'), 10).

Custom Keyword tools

Tool	Description	Example Prompt
getCustomKeywords	Get a list of all custom keywords in the current project	Get custom keywords in this project.
getCustomKeyword	Get a custom keyword class file with the name you provide and return its content	Get custom keyword content for class ‘example_keyword_class.’
createCustomKeyword	Create a new custom keyword class with content you specify. The keyword will be saved in the Keywords source folder.	Create custom keyword ‘example_keyword_class’ with method def printMessage(){ println("Hello from custom keyword!") }.
updateCustomKeyword	Update an existing custom keyword class file. Can update the content and optionally rename/move the keyword to a different package/class name.	Update custom keyword ‘example_keyword_class’: change name to ‘example_user_actions’, add new method def verifyLogin().

Test Object tools

tip

• For a more stable workflow, use getTestObjects to retrieve all Test Objects in your project before using other Test Object tools.
• When creating or updating Test Objects, include both a locator strategy and its full path (e.g. xpath: /html/body/header/div/a) in your prompt. See the sample prompts below for guidance.
• (Optional) Set up Selenium MCP server for StudioAssist can help StudioAssist understand your project context more accurately, and generate Test Objects with less detailed prompting. See example prompt with Selenium MCP server integrated in the createTestObject tool below.

Limitations

• AWS Bedrock provider does not support createTestObject or updateTestObject tools yet. As a result, StudioAssist cannot create or updates when using Bedrock-based models.

• Gemini provider may not reliably execute createTestObject and updateTestObject actions. To ensure the model interprets your request correctly, you can create a custom instruction file (e.g., Web test object) that describes the test object you want to create, and include real examples from your project, then attach this file whenever you prompt StudioAssist to create or update a test object.

• You can choose other existing support AI models instead. See our supported AI models at AI service configuration.

Tool	Description	Example Prompt
getTestObjects	Get a list of all test object IDs from the current project	Get test objects in this project.
createTestObject	Creates a new test object in the Object Repository with a suggested locator strategy based on locator information. Supports Web, Mobile, Windows, and Web Service test objects.	Create new web test object "make appointment button" at https://katalon-demo-cura.herokuapp.com/ with full xpath locator "/html/body/header/div/a" *With selenium mcp integrated: Create new test object "make appointment button" at https://katalon-demo-cura.herokuapp.com/
updateTestObject	Updates an existing test object in the Object Repository based on its ID in the current Katalon Studio project. Supports Web, Mobile, Windows, and Web Service test objects.	update test object "make appointment button", to use css path locator "#btn-make-appointment"
getTestObject	Retrieves detailed information about a test object from the Object Repository based on its ID in the current Katalon Studio project.	get test object "make appointment" button

Test Suite tools

Tool	Description	Example Prompt
getTestSuite	Get details of a specific test suite in the current Katalon Studio project	Get test suite ‘example_test_suite.’
createTestSuite	Create a new test suite with metadata and test cases in the current Katalon Studio project	Create test suite ‘example_test_suite’ that includes: ‘example_test_case_1’, ‘example_login_case_1.’
updateTestSuite	Update an existing test suite with new metadata and test cases in the current Katalon Studio project	Update test suite ‘example_checkout_case_1’: add ‘example_test_suite_1.’ to end of test suite.
createDynamicTestSuite	Create a new dynamic test suite with metadata and filtering configuration in the current Katalon Studio project	Create dynamic test suite ‘example_dynamic_test_suite_1’: include all test cases tagged ‘regression.’
updateDynamicTestSuite	Update an existing dynamic test suite with new metadata and filtering configuration in the current Katalon Studio project	Update dynamic test suite ‘example_dynamic_test_suite’: only include test cases tagged ‘critical.’

Test Suite Collection tools

Tool	Description	Example Prompt
createTestSuiteCollection	Creates a new test suite collection with metadata and test suites in the current Katalon Studio project	Create test suite collection with all test suites in this project.
updateTestSuiteCollection	Update an existing test suite collection with new metadata and test suites in the current Katalon Studio project	update test suite collection regression_test_collection to include example_test_suite_1

BDD (Behavior-driven development) testing tools

Tool	Description	Example Prompt
createBddFeatureFile	Create a new BDD feature file with Gherkin content in the current Katalon Studio project	Create Bdd feature file ‘example_feature_file’: add the following Gherkin content: Feature: Login Scenario: Valid login Given user is on the login page When user enters valid credentials Then the homepage is displayed.
updateBddFeatureFile	Update an existing BDD feature file’s content, name, and/or location in the current Katalon Studio project	Update BDD feature file: update name ‘example_feature_file’ to ‘example_login_feature’, add a new scenario for invalid login.

Test Data tools

Tool	Description	Example Prompt
getTestDataList	Get a list of all test data entities available in the current Katalon Studio project	Get test data list of all test data files in this project.
createInternalTestData	Create a new internal test data entity with specified data in the current Katalon Studio project	Create internal test data ‘example_test_data’ using the table ‘sample_data_for_test_case.’

Katalon TestOps MCP Server

Starting version 10.4.0, Katalon Studio supports TestOps MCP Server, supporting users on TestOps (not including TestOps Legacy). See TestOps MCP Server for more details on configurations and tool list.

note

• StudioAssist uses the authentication information from the Katalon Studio login to smoothly integrate with TestOps MCP Server.
• TestOps MCP Server currently doesn't support integration for Katalon Studio accounts using offline license
• For better results, specify the project ID in your prompts if you think StudioAssist will use TestOps MCP Servers.