vouchfx-mcp GitHub
Documentation / VFX-E-1401

VFX-E-1401

Title

EngineCliUnavailable

Explanation

The pinned vouchfx CLI is missing, version-mismatched, unparseable, or not launchable. Shared by all five CLI-backed tools — list_step_types, describe_step_type, plan_coverage, scaffold_suite, and run_suite — because the condition and its remediation are identical for every one of them: the environment this server orchestrates through is not available.

Common causes

  • The vouchfx CLI is not installed, or not on PATH for the account running vouchfx-mcp.
  • An installed CLI's version does not match this server's own ENGINE_PIN.
  • The CLI is installed but not launchable (a corrupted install, a missing runtime dependency), or its version output could not be parsed.

Fixes

  • Install the vouchfx dotnet tool at the version named in this repository's ENGINE_PIN file: dotnet tool install -g vouchfx --version <pinned-version>.
  • Run vouchfx --version yourself to confirm it is on PATH and launches successfully.
  • If a different CLI version is intentionally installed, this server's ENGINE_PIN needs advancing — a maintainer/release task, not something a single call can work around.