# detect-motor-fault

`station__actuator-systems__detect-motor-fault` · external (needs EXECUTION_BACKEND_URL configured) · domain `actuator-systems` · pv-relevance `non-pv`

Detect motor/actuator faults from sensor readings. 7 fault types: winding overtemp (critical/warning), overcurrent (critical/warning), encoder loss, stall, phase imbalance. Returns fault type, severity, and recommended action.

> **Note:** This tool routes through an external execution backend. If `EXECUTION_BACKEND_URL` is unset on the server, calls return JSON-RPC error `-32603 "Tool execution backend not configured"`. Tools with `backend: native` execute in-process and are always callable.

## Agent metadata

- `idempotent`: unknown
- `read_only`: unknown
- `expected_latency_ms`: unknown (not yet contract-tested)
- `cost_tokens_estimate`: unknown

## Input schema

- `phase_current_a` *number* (required) — RMS phase current in amps
- `winding_temp_c` *number* — Motor winding temperature in Celsius
- `rpm` *number* — Current motor speed in RPM
- `encoder_valid` *boolean* — Whether encoder feedback is valid
- `phase_balance_pct` *number* — Phase current balance percentage

## Example call

```json
POST /api/mcp
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "station__actuator-systems__detect-motor-fault",
    "arguments": {
      "phase_current_a": 0
    }
  }
}
```

## Related

- [/tools](/tools) — all 3062 tools
- [/tools/actuator-systems__detect-motor-fault](/tools/actuator-systems__detect-motor-fault) — HTML page
- [/tools/actuator-systems__detect-motor-fault/json](/tools/actuator-systems__detect-motor-fault/json) — JSON form (agent-friendly)
- [/api/mcp](/api/mcp) — endpoint
- [/AGENTS.md](/AGENTS.md) — agent guide