# Standard Machinist - AI Agent & CAD Automation Reference
> Parametric mechanical engineering, physics verification, and OpenCASCADE STEP CAD generation engine for standard components.

## Capabilities for AI Agents
Standard Machinist provides a headless REST API for AI design agents, CAD copilots (FreeCAD, Fusion 360, Blender), and robotic hardware pipelines.

1. **Schema Discovery**: Query allowable bounds, dimensions, materials, and end configurations.
2. **Physics & Fatigue Verification**: Calculate spring stiffness (N/mm), shear stress, safety factors, and solid height before generating CAD.
3. **B2B Parametric Quoting**: Retrieve live manufacturing pricing, batch setup decay, and lead times.
4. **Headless STEP CAD Generation**: Generate and download manufacturing-grade `ISO-10303-21` STEP 3D CAD models.

## Core Endpoints
- **OpenAPI 3.1 Specification**: `GET /api/v1/openapi.json`
- **Schema Discovery**: `GET /api/v1/schema/{category}` (e.g., `springs`, `gears`)
- **Physics Analysis**: `POST /api/v1/calculate`
- **Parametric Quoting**: `POST /api/v1/quote`
- **STEP CAD Exporter**: `POST /api/v1/cad/step`

## Example: Compression Spring CAD & Physics Request
```json
// POST /api/v1/calculate
{
  "category": "springs",
  "specs": {
    "springType": "Compression",
    "wireDiameter": 2.0,
    "outerDiameter": 20.0,
    "freeLength": 50.0,
    "turns": 10.0,
    "endType": "Squared & Ground",
    "material": "Steel"
  },
  "testMode": {
    "inputMode": "load",
    "operatingLoad": 50.0
  }
}
```

```json
// POST /api/v1/cad/step -> Streams ISO-10303-21 .step binary file
{
  "specs": {
    "springType": "Compression",
    "wireDiameter": 2.0,
    "outerDiameter": 20.0,
    "freeLength": 50.0,
    "turns": 10.0,
    "endType": "Squared & Ground"
  }
}
```

## Detailed Documentation & Interactive Console
Visit `/docs` on this domain for the full interactive developer portal.