vouchfx-mcp GitHub
Documentation / VFX-D-1201

VFX-D-1201

Title

UnknownStepType

Explanation

A step's type matches no step type the pinned engine's catalogue defines. Reported as validation data on a successful call — distinct from VFX-E-1250 (StepTypeNotInCatalogue), which fires when describe_step_type itself is asked about an unknown type; this code instead describes a suite that references one.

Common causes

  • A typo in a step's type field (e.g. http.rst instead of http.rest).
  • Referencing a step type from a different engine version than the one currently pinned (ENGINE_PIN).
  • Copy-pasting a step from a different project whose engine defines additional step types this one does not.

Fixes

  • Call list_step_types to see every step type the pinned engine actually supports.
  • Compare the type string carefully — dotted <family>.<provider> form, case-sensitive.
  • Use describe_step_type on the corrected type to confirm its field contract before fixing the suite.