This topic describes each capability that the TestComplete MCP server exposes. You trigger these capabilities through natural-language conversation with your AI client.
Verify the connection
The AI assistant can confirm that it is connected to a live TestComplete instance. The assistant does the following:
-
Sends a ping to the MCP server and reports whether TestComplete is reachable.
-
Confirms the connection before you run any other operation, and reports any connection problems that it finds.
Explore your test project
After you connect, the AI assistant can read and report on everything in the open TestComplete project:
| Ask the AI assistant to | Result |
|---|---|
List keyword tests |
The names of all keyword-driven tests in the project. |
List script tests |
The names of all script-based tests in the project. |
Show the code for a test |
The full source code of the requested script test. |
Show the execution plan |
The list of tests scheduled to run, in order. |
List name mappings |
The mapped object aliases that tests use to refer to user interface elements. |
List project variables |
The variables defined at the project level. |
List variables for a test |
The variables defined for a specific test. |
List tested applications |
The applications registered in the project as the applications under test. |
| Note: |
TestComplete never sends the values of variables marked as Password or Secret to the AI assistant. This behavior is built in, and you cannot turn it off. |
Open and close project suites
The AI assistant can manage which project suite is open in TestComplete. This lets the assistant work against the right project without you switching manually in the TestComplete user interface.
-
Ask the assistant to open a specific project suite by name or by path. If the project suite cannot be found, the assistant returns an error message.
-
Ask the assistant to close the currently open project suite.
Run tests
The AI assistant can start test runs directly in TestComplete:
-
Ask the assistant to run a specific script test by name.
-
Ask the assistant to run a specific keyword test by name.
| Note: |
When a test runs, TestComplete takes control of the mouse and the keyboard on the host machine. The AI assistant warns you before it starts a run. Do not use the mouse or the keyboard while a test is running. |
View test logs and results
After a test run, the AI assistant can retrieve and summarize the results:
-
Returns all logs for a test, with a timestamp and a result status of success, warning, or error. You can filter the logs by date range, by number of results, and by detail level. The default limit is 50 logs.
-
Shows a step-by-step breakdown of what happened during a test run. Execution plan logs and multiple test logs are supported.
See Also
Getting Started with TestComplete MCP
Connect to the MCP Server
Known Limitations