vouchfx-mcp GitHub
Documentation / VFX-E-1903

VFX-E-1903

Title

UnknownDiagnosticCode

Explanation

explain_diagnostic was asked to explain a VFX-D-####/VFX-E-#### code this server has no catalogue entry for. Distinct from VFX-E-1902 (UnrecognisedOutcome): that code fires when THIS SERVER's own outcome switch hits its unreachable default arm, never provoked by caller input. This code fires on a value a caller typed into explain_diagnostic's code argument — ordinary bad input, the same shape as VFX-E-1250 for an unknown step type.

Common causes

  • A typo in the code argument (transposed digits, or the wrong prefix letter — VFX-D- vs VFX-E-).
  • Asking about a code from a different (older or newer) vouchfx-mcp version than the one actually running.
  • Passing a value that was never a vouchfx code at all — an engine-native identifier, or a code belonging to a different tool entirely.

Fixes

  • Copy the code directly from the code field of the VfxError/Diagnostic you are asking about, rather than retyping it.
  • Confirm the code matches the VFX-D-#### / VFX-E-#### pattern exactly, including the dash placement.
  • If you believe the code IS one this server should emit, confirm you are running the version that actually mints it — a stale local record of known codes can go out of date.