Perfecto MCP server
The Perfecto Model Control Protocol (MCP) server connects AI tools directly to Perfecto's cloud-based testing platform. MCP acts as a bridge between AI agents and testing workflows, enabling assistants and chatbots to create, execute, and report on tests, all through natural language interactions.
Read this article to understand the purpose and benefits of the Perfecto MCP server, explore common use cases, and learn how it integrates with other Perfecto components. You’ll also find guidance on troubleshooting and limitations, plus links to licensing and support resources.
To set up the MCP server and start using it, see the Prerequisites and Setup information in the GitHub repository.
On this page:
Use cases
The MCP server enables AI-driven automation across multiple testing scenarios, reducing manual effort and accelerating workflows:
-
Cross-platform device testing: Validate applications on real, virtual, and desktop devices
-
Live test monitoring: Track execution status and intervene in real time
-
Execution history analysis: Review and filter past test runs for trends and troubleshooting
-
Automated test management: Integrate device and execution operations into CI/CD workflows
-
Centralized device inventory: Maintain an up-to-date catalog of available testing devices
-
In-platform troubleshooting: Access help content and command references directly within the platform
By making Perfecto’s enterprise-grade testing platform AI-accessible, MCP helps teams streamline complex workflows, improve test coverage, and accelerate delivery without requiring deep platform expertise.
Integration points and actions
The MCP server exposes Perfecto’s core functionality through AI hosts, such as VS Code or Claude Desktop, allowing you to perform actions using natural language or structured prompts. These actions are organized into the following areas that reflect different aspects of the Perfecto platform.
| Area | Action | Description | Sample prompt |
|---|---|---|---|
|
User management |
Get user info |
Get current user details from Perfecto |
“Show my Perfecto account info” |
|
Device management |
Get Selenium Grid info |
Retrieve main Selenium Grid details, including URLs for Selenium and Appium |
“Show Selenium Grid info” |
|
Get real device listing |
List all available real devices (iOS/Android, mobile/tablet) |
“List available Android devices” |
|
|
Get real device details |
Read comprehensive information for a specific real device |
“Get details for device ID 12345” |
|
|
Get virtual device listing |
List all available virtual devices (iOS simulators, Android emulators) |
“Show iOS simulators” |
|
|
Get desktop device listing |
List all available desktop browser devices |
“List desktop browser devices” |
|
|
Test execution |
List execution listing |
List all ongoing executions (mobile, tablet, desktop browser) |
“Show all running tests” |
|
Control executions |
Stop one or more live executions by ID |
“Stop execution ID 67890” |
|
|
List execution history |
List finished executions with advanced filtering |
“Filter past runs by failure reason” |
|
|
Get report name listing |
List all available report names for executions |
“Show report names” |
|
| Filter value discovery |
Retrieve valid filter values for execution queries (device IDs, OS, browsers) |
“Show valid filter values for executions” |
|
| List Scriptless Mobile tests | List all available Scriptless Mobile tests in Perfecto | "List my Scriptless Mobile tests" | |
| Run Scriptless Mobile test | Execute a Scriptless Mobile test by name or ID | "Run Scriptless Mobile test <name/ID>" | |
|
Project configuration |
Configure Espresso project |
Apply Perfecto settings automatically for Espresso |
“Configure my Espresso project with Perfecto” |
|
Configure XCTest project |
Apply Perfecto settings automatically for XCTest |
“Set up my XCTest project for Perfecto” |
|
|
Help management |
Get help category listing |
List all help categories and their subcategories |
“Show help categories” |
| Discover help content |
List all help topics within a category and subcategory |
“Search help for Appium commands” |
|
|
Read help content |
Retrieve detailed help content by category, subcategory, and topic |
“Read help content for Appium setup” |
|
|
List extended command listings |
List all supported extended RemoteWebDriver commands (Perfecto function reference) |
“List extended Selenium commands” |
|
|
Get extended command details |
Read comprehensive information for a specific extended command |
“Show details for command XYZ” |
These integration points make it possible for AI agents and assistants to manage testing workflows without requiring deep platform knowledge.
License
The Perfecto MCP server is distributed under the Apache License, Version 2.0.
For full license terms, see the License information in the GitHub repository.
Support
To report an issue or open a feature request, use GitHub.
For help with configuration, troubleshooting, or advanced use cases, contact Perfecto Support.