# Perfecto MCP for AI Agents AI Agent Connect

> Perfecto MCP helps you manage and query your Perfecto Cloud testing environment. It lets your AI agent find specific mobile devices, check test execution statuses, pull Smart Reporting summaries, and audit repository artifacts without you having to click through the web dashboard.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_qkMLVDlhWeRHbw49znraw9alYWakOJ9o2dj1pqaq/ai-agent-connect
- **Tags:** qa-automation, software-testing, cloud-testing, test-reporting, mobile-testing, execution-logs

## Description

Imagine you're in the middle of a release cycle and a test suite just failed on a specific Android model. Usually, you'd have to log into the Perfecto dashboard, navigate through the execution history, and dig through logs to figure out what happened. This Connector changes that. It gives your AI agent the ability to talk directly to your Perfecto Cloud. Instead of manual searching, you can just ask your agent to find the specific device metadata, check the status of a running execution, or pull a report summary for a specific test run. It handles the heavy lifting of parsing the JSON outputs and finding the right artifacts in your repository. You can even use it to see who's currently using which device or check your license limits. By adding this to the Vinkius catalog, you're giving your agent the eyes it needs to monitor your testing infrastructure in real time. It turns a multi-tab research task into a single conversation.

## Tools

### list_devices
Get a list of all devices on your Perfecto Cloud including models, OS versions, and locations.

### get_device_details
Pull full specs for a specific device like firmware, resolution, and current status.

### list_executions
See all recent and current executions with statuses and script names.

### get_report_summary
Get a summary of test results, pass/fail counts, and video links from Smart Reporting.

### list_device_groups
View how your devices are organized into groups by team or OS.

### list_reservations
See which users have reserved which devices and for how long.

### get_license_info
Check your license type, device limits, and concurrent execution counts.

### get_execution_details
Get the progress and device assignments for a specific execution ID.

### list_artifacts
Find apps, scripts, and data files in a specific Perfecto repository path.

### list_users
See all users on your Perfecto cloud along with their roles and access levels.

## Prompt Examples

**Prompt:** 
```
Which Android devices are available for testing right now?
```

**Response:** 
```
### Available Android Devices

| Model | OS Version | Location | Status |
| :--- | :--- | :--- | :--- |
| Samsung Galaxy S23 | Android 14 | US East | **Available** |
| Google Pixel 7 | Android 13 | US West | **Available** |
| OnePlus 11 | Android 14 | EU West | **Available** |

*All devices are ready for immediate assignment.*
```

**Prompt:** 
```
Give me a summary of the test results for execution ID 'exe_882'.
```

**Response:** 
```
**Execution Summary: exe_882**

*   **Status:** Failed
*   **Pass Count:** 42
*   **Fail Count:** 3
*   **Total Steps:** 45

**Failure Details:**
*   Step 12: Login button not clickable.
*   Step 15: Timeout on profile load.

[View Video Recording](https://perfecto.io/v/882)
[View Screenshot](https://perfecto.io/s/882)
```

**Prompt:** 
```
Are we hitting our concurrent execution limit?
```

**Response:** 
```
**License Usage Report**

*   **Current Concurrent Executions:** 18
*   **License Limit:** 20
*   **Remaining Capacity:** 2

*Warning: You are approaching your limit. Consider releasing finished executions to free up space.*
```

## Capabilities

### Find available devices
Get a list of real Android and iOS devices ready for testing.

### Check execution status
See if your tests are running, finished, or failed instantly.

### Pull report summaries
Get pass/fail counts and video links for specific test runs.

### Browse repository artifacts
Locate apps, scripts, and images stored in your cloud.

### Manage device groups
View how your devices are organized by team or OS.

### Audit license usage
Check your current device limits and concurrent execution counts.

## Use Cases

### Checking a failed test
An SDET asks the agent to pull a report summary for a specific execution ID to see why a login test failed.

### Finding free hardware
A QA engineer asks which iPhones are currently available in the cloud to start a new mobile test suite.

### Auditing repository contents
A developer wants to know what scripts are currently in a specific storage bucket and asks the agent to list the artifacts.

### License monitoring
A manager asks the agent to check the current concurrent execution count to see if they're hitting their license limits.

## Benefits

- Stop digging through the web dashboard because list_devices and list_executions let your agent do the searching for you.
- Get instant feedback on test failures by using get_report_summary to pull pass/fail counts and video links immediately.
- Save time on device planning by using list_device_groups and list_reservations to see what's available and who's using it.
- Simplify artifact management by using list_artifacts to find scripts and apps in your repository without manual navigation.
- Monitor your costs and capacity with get_license_info to keep your testing infrastructure within its limits.
- Speed up debugging by using get_device_details to get firmware and resolution data for a specific device in one go.

## How It Works

The bottom line is that your AI agent can now act as a primary interface for your entire Perfecto testing environment.

1. Provide your Perfecto Cloud host URL and your API testing token.
2. Connect the Connector to your preferred AI client.
3. Ask your agent to find devices, pull reports, or check execution logs.

## Frequently Asked Questions

**Can the Perfecto MCP help me find specific mobile devices?**
Yes, it lets your agent list all available devices in your Perfecto Cloud and show you details like OS version and manufacturer.

**How does this help with test reporting?**
Your agent can pull a summary of test results, including pass/fail counts and links to videos or screenshots, directly from the cloud.

**Can I use this to see who is using which device?**
Yes, it can list active reservations so you know which users have booked specific devices and for how long.

**Does this Connector work for both mobile and web testing?**
It works for whatever devices and environments you have configured in your Perfecto Cloud, including real mobile devices and browsers.

**Can my agent find files in my Perfecto repository?**
It can list artifacts like apps, scripts, and data files at specific paths in your repository.

**Is this tool for running my automated tests?**
No, this Connector is for managing the environment and retrieving data. It helps you find devices and reports rather than executing the test scripts themselves.

**How explicitly strict are the parameter mappings defining target Perfecto Clouds naturally?**
Absolutely structurally globally bound. Organizations utilize specific native tenant endpoints natively safely safely explicit. You explicitly assign your sub-domain string efficiently natively (e.g., `mycorp.perfectomobile.com`) elegantly securely validating parameters smoothly matching targeted servers seamlessly safely explicitly perfectly.

**Can I logically trigger a live execution pipeline explicitly securely here seamlessly?**
The bounds mapping executed safely extract JSON reading matrices isolating analytics explicitly (listing, verifying, tracking reports securely appropriately accurately properly efficiently explicitly naturally safely inherently properly cleanly). Active creation boundaries triggering physical grid pipelines explicitly inherently decoupled strictly for testing boundaries integrity beautifully efficiently safely completely explicitly natively efficiently safely fully dynamically internally successfully.

**Where strictly explicitly do I locate my native Security API key bounded gracefully inside settings?**
Explore explicit parameters exploring inside native UI boundaries effectively structurally tracking 'My Profile > Security Token' natively seamlessly generating offline hashes explicitly carefully correctly safely tracking parameters beautifully correctly.