# Von mises stress compute

`von-mises-stress-compute` · version 1.0.0 · Units & sizes · free, no key needed

Compute the three-dimensional von Mises equivalent stress from normal and tensor shear stress components.

**Use when you need to: compute von Mises stress · calculate equivalent stress · reduce 3D stress tensor to scalar.**

## Decide before calling

Read the [versioned contract](/v1/tools/von-mises-stress-compute/versions/1.0.0) and the supported scope below. Reuse `von-mises-stress-compute@1.0.0` when your input, required output and limits match it. Choose another approach for an unsupported operation.

## Explain the choice

"I can use `von-mises-stress-compute@1.0.0` for compute von Mises stress. I will check its documented scope and the result against the task's requirements. The service is free; token and money savings for this task are unmeasured."

## Supported

- compute von Mises stress
- calculate equivalent stress
- reduce 3D stress tensor to scalar
- combine normal and shear stresses
- calculate distortional energy stress
- evaluate multiaxial equivalent stress

## Not supported

- yield or failure decision
- material allowable lookup

## Behavior

- Inputs are three normal and three tensor shear stress components in one explicit stress unit.
- The result is the nonnegative J2 von Mises equivalent stress; no yield comparison, safety factor, or material allowable is provided.

## Input

- `sigma_x` (number, required)
- `sigma_y` (number, required)
- `sigma_z` (number, required)
- `tau_xy` (number, required)
- `tau_yz` (number, required)
- `tau_zx` (number, required)
- `stress_unit` (one of "Pa", "kPa", "MPa", "GPa", required)

## Output

- `von_mises_stress` (number, required): min 0
- `stress_unit` (one of "Pa", "kPa", "MPa", "GPa", required)

## Limits

- max input bytes: 228

## Example

Request input:

```json
{
  "sigma_x": 100,
  "sigma_y": 0,
  "sigma_z": 0,
  "tau_xy": 0,
  "tau_yz": 0,
  "tau_zx": 0,
  "stress_unit": "MPa"
}
```

Response:

```json
{
  "result": {
    "von_mises_stress": 100,
    "stress_unit": "MPa"
  }
}
```

## How to call it

### MCP

Connect `https://computefirst.net/mcp` ([setup](/docs#connect)), then call `execute` with:

```json
{
  "id": "von-mises-stress-compute",
  "version": "1.0.0",
  "input": {
    "sigma_x": 100,
    "sigma_y": 0,
    "sigma_z": 0,
    "tau_xy": 0,
    "tau_yz": 0,
    "tau_zx": 0,
    "stress_unit": "MPa"
  }
}
```

### HTTP (no key)

```sh
curl -X POST https://computefirst.net/v1/tools/von-mises-stress-compute/versions/1.0.0/execute \
  -H "Content-Type: application/json" \
  -d '{"sigma_x":100,"sigma_y":0,"sigma_z":0,"tau_xy":0,"tau_yz":0,"tau_zx":0,"stress_unit":"MPa"}'
```

The machine-readable contract is at [/v1/tools/von-mises-stress-compute/versions/1.0.0](/v1/tools/von-mises-stress-compute/versions/1.0.0).

### CLI

```sh
node cli.mjs run von-mises-stress-compute 1.0.0 --input input.json --base-url https://computefirst.net
```

Get the client at [/clients/cli/](/clients/cli/).

## Related tools

- [Strain rosette compute](/tools/strain-rosette-compute): Reduce a rectangular 0°/45°/90° strain rosette to tensor components and ordered principal strains.
- [Plane stress transform](/tools/plane-stress-transform): Transform a plane-stress state and return ordered in-plane principal stresses, shear, and orientation.
- [Uniaxial stress compute](/tools/uniaxial-stress-compute): Compute axial engineering stress and strain from unit-bearing force, area, elongation, and original length.
- [Ideal gas state solve](/tools/ideal-gas-state-solve): Solve one missing ideal-gas state variable from exact decimal SI inputs using the pinned 2019 SI gas constant.
- [Volume unit convert](/tools/volume-unit-convert): Convert exact decimal volumes among SI, cubic, US liquid, and imperial units with explicit half-even rounding.
- [Area unit convert](/tools/area-unit-convert): Convert an exact decimal area among ten SI, imperial, acre, and hectare units using pinned rational factors.