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.
  • list_step_types or describe_step_type only: the CLI could not load a configured external provider location (engine v1.2.0 and later), for example a VOUCHFX_PROVIDERS entry naming a directory that does not exist, so vouchfx list --json exited 3. The version check passes in this case, and the other CLI-backed tools report the same condition under their own codes.

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.
  • Run vouchfx list --json in this server's environment. If it reports a provider error, correct or unset VOUCHFX_PROVIDERS, or repair ~/.vouchfx/providers with vouchfx providers uninstall and vouchfx providers install; reinstalling the CLI does not help. A changed VOUCHFX_PROVIDERS takes effect only after this server restarts.