v1.2.0

What's new in Perfecto MCP

Streamable HTTP transport

Note

v1.1.x ran over stdio only (local binary, uvx, Docker).
v1.2.0 adds hosted HTTP so one server can serve multiple users and Perfecto clouds:

• Run with perfecto-mcp --mcp http (or PERFECTO_MCP_TRANSPORT=http)
• Per-request auth via Authorization: Bearer <securityToken>
• Target cloud via Perfecto-Cloud-Name header (falls back to PERFECTO_CLOUD_NAME)
• Unauthenticated health probes at /health and /healthz
• Operator guide: docs/hosted-http.md

AI Scriptless — contracts, validation, and richer editing

• Command contracts: Authoring now uses Perfecto command repository definitions (data.type, errorPolicy, mandatory/optional parameters) instead of inferring them locally
• Argument validation: Names, values, ranges, enums, and variable bindings are checked before write — typos no longer silently become no-ops at runtime
• Error policies: Support for ABORT, IGNORE, BREAK, CONTINUE, and CATCH via set_command_error_policy
• Conditions: Clearer condition workflow — branch depends on the preceding step marked with CATCH (no expression to set)
• Step detail view: New view_test_step action with richer argument/parameter metadata for editing
• Variables: Broader variable type / dual-store support (including device and DataTable-style bindings)
• Agent hints: Improved collision guidance when command args (e.g. ai_user-action's action) clash with the tool dispatcher

Tool argument handling

• Standardized normalize_action_args across all MCP tool managers
• More resilient to client payload shape differences (arguments vs flat / aliased forms)
• AI Scriptless command args renamed to cmd_arguments to avoid colliding with top-level action / arguments

Documentation

• New Transports section in the README
• New hosted HTTP operator guide

Distribution

• Binary artifacts refreshed for all platforms (macOS .app, Linux, Windows)

What's Changed

• Add initial Transport and Streamable HTTP support by @3dgiordano in #44
• Enhancements to AI Scriptless by @3dgiordano in #45
• Improve ambiguity handling in argument processing by @3dgiordano in #43
• Release v1.2.0 by @diego-ferrand in #46
  Full Changelog: v1.1.2...v1.2.0

v1.1.2

What's new in Perfecto MCP

Version & update tools:

• New tools_manager MCP tool with version and check_updates actions
• Reports runtime/platform info and checks GitHub releases for newer builds
• GitHub URLs updated to the PerfectoCode organization

Security hardening:

• HTTP endpoint allowlist / SSRF protection for outbound requests
• Traceback sanitization to avoid leaking absolute paths and secrets
• Stricter PerfectoToken validation with sanitized errors/repr
• Help HTML hardening (safer link/href handling)

Dependencies & supply chain:

• Bumped mcp[cli] to >=1.27.0,<2.0.0 (upper bound to avoid MCP 2.x breakage)
• Dependency updates for known vulns; added Mend (WhiteSource) SCA/SAST config and CI
• Added SECURITY.md for responsible disclosure

Observability:

• OpenTelemetry docs in the README (disable via OTEL_SDK_DISABLED, custom collector, what is/isn’t reported)

Build:

• Ubuntu build image upgraded from 25.10 → 26.04 (Dockerfile + CI)
• Binary artifacts refreshed for all platforms

Version update

• Bumped project version from 1.1.1 to 1.1.2

What's Changed

• Upgrade ubuntu image to use latest lts by @diego-ferrand in #34
• Add Perfecto MCP version info and GitHub update-check tools by @diego-ferrand in #37
• Add HTTP allowlist, traceback sanitization, and help HTML hardening w… by @diego-ferrand in #38
• Added mend by @diego-ferrand in #36
• Added OTEL documentation by @diego-ferrand in #35
• Add upper bound in mcp dependency by @Baraujo25 in #41
• Upgrade Ubuntu image and enhance security with updates and tests by @Baraujo25 in #42

Full Changelog: v1.1.1...v1.1.2

v1.1.1

What's new in Perfecto MCP

Packaging fixes for uv/pip installs:

• Fixed the packaging issue that could break uv/pip installs with ModuleNotFoundError: No module named 'tools.ai_scriptless'
• Updated package discovery so the tools package and its submodules are included correctly
• Added the config package marker to ensure config module packaging is included in distributions

Version update

• Bumped the project version from 1.1.0 to 1.1.1

Documentation

• Updated the README installation reference to use perfecto-mcp v1.1.1

Release execution

• Includes the release preparation and publication updates for v1.1.1

What's Changed

• Initialize config module and include tools subpackages by @Baraujo25 in #31
• Acomodate for release v1.1.1 by @Baraujo25 in #32
• Release v1.1.1 by @Baraujo25 in #33

Full Changelog: v1.1.0...v1.1.1

v1.1.0

What's new in Perfecto MCP

AI Scriptless — full test authoring and management

Note

v1.0.1 supported listing and executing AI Scriptless tests.

v1.1.0 adds a full editor workflow through the perfecto_ai_scriptless tool:

• Test structure: View hierarchical script trees with step_path addressing (view_test_structure)
• Command catalog: Browse available commands, get parameter definitions, and follow built-in command selection guidance for agents (list_commands,
  get_command_definitions)
• Step editing: Add, modify, delete, enable/disable, and move commands (add_command, modify_command, delete_command, set_command_enabled, move_command)
• Control flow: Build LogicalStep groups, loops, and If/Then/Else conditions (add_logical_step, add_loop, add_condition, set_condition_expression)
• Test lifecycle: Create, save, save-as, move, and delete tests (create_test, save_test, save_test_as, move_test, delete_test)
• Version history: List and view snapshot history (list_snapshots, view_snapshot)
• Script variables: Manage test-level variables distinct from DUT parameters (list_test_variables, add_test_variable, modify_test_variable,
  delete_test_variable)
• Improved script tree display: Step names now include relevant parameter values, aligned with Perfecto UI conventions

OpenTelemetry tracing and metrics

• Distributed tracing and metrics collection for all MCP tool calls
• Automatic instrumentation of tool duration, call counts, and error types
• Configurable via environment variables (OTEL_SDK_DISABLED, OTEL_EXPORTER_OTLP_ENDPOINT, OTEL_EXPORTER_OTLP_PROTOCOL)
• Graceful degradation when OpenTelemetry dependencies are unavailable
  User context enhancements
• User information now includes cloud_name and cloud_url for better Perfecto cloud context in agent responses

Documentation

• Docker examples in the README now include --pull=always so containers always use the latest image

Distribution and packaging

• macOS: Binaries shipped as signed .app bundles (perfecto-mcp-amd64.app.zip, perfecto-mcp-arm64.app.zip)
• Linux: perfecto-mcp-linux-amd64 binary with GPG signature (.asc)
• Windows: Standalone perfecto-mcp-windows-amd64.exe

What's Changed

• Enable docker always pull to be up to date by @Baraujo25 in #21
• Enable Docker to always pull the latest images by @Baraujo25 in #22
• Improvements in AI Scriptless testing by @3dgiordano in #23
• Add OpenTelemetry tracing and metrics for MCP tool calls by @diego-ferrand in #24
• Improve script tree display in AI Scriptless by @3dgiordano in #25
• Release 1.1.0 by @3dgiordano in #26
• Save minimun layers in gh caché by @Baraujo25 in #27
• Docker build updates by @Baraujo25 in #28
• Disable Docker cache in GitHub Actions by @Baraujo25 in #30

Full Changelog: v1.0.1...v1.1.0

v1.0.1

What's new in Perfecto MCP

Execution manager filter enhancements:

• Now you are able to filter by status when retrieving executions

Documentation

• Several changes done in the README file to ease installation process
• Check out the new video demo installation at: README.md

What's Changed

• Add mend scan by @Baraujo25 in #7
• Add correct tag for docker image by @diego-ferrand in #8
• Remove use cases and available tools documentation by @Baraujo25 in #10
• Handle None values in user formatter to prevent TypeError by @Baraujo25 in #11
• Updated README.md by @alejandroaires in #12
• Setup Mend CLI scan by @Baraujo25 in #14
• Status filter added by @3dgiordano in #13
• Release 1.0.1 by @Baraujo25 in #15
• Fix commit artifact workflow by @Baraujo25 in #16
• Fix commit artifact workflow and update Actions compliance by @Baraujo25 in #17
• Docker build workflow trigger only after success dist commit by @Baraujo25 in #18
• Trigger Docker build workflow after successful dist commit by @Baraujo25 in #19

Full Changelog: v1.0...v1.0.1

1.0

What's new on the Perfecto MCP:

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

Refer to the README file for further information and installation process.

Full Changelog: https://github.com/PerfectoCode/perfecto-mcp/commits/v1.0