# CAD MCP Server (npm · cad-mcp-server)

STEP file inspection for AI. Measure walls, draft angles, clearances. Returns facts, not guesses.

- Trust score: 77/100 (medium)
- Change this week: −12
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- npm · `cad-mcp-server`: 77/100 (this document), [markdown](https://verifymcp.io/servers/mattmohandiss-cad-mcp-server/cad-mcp-server.md), [page](https://verifymcp.io/servers/mattmohandiss-cad-mcp-server/cad-mcp-server)

## Channel facts

- Registry: `npm`
- Package: `cad-mcp-server`
- Version: `0.6.1`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Supply Chain Security**: 81/100
  - No malware found by supply-chain analysis.
  - Only part of the dependency tree could be resolved (2 of 3), so this covers what we could see, not the whole tree.
  - No install/post-install scripts declared.
  - Only part of the dependency tree could be resolved (2 of 3), so this covers what we could see, not the whole tree.
- **Provenance & Transparency**: 97/100
  - Source repository is publicly reachable at the declared URL.
  - Cryptographically verified build provenance (signed, bound to mattmohandiss/cad-mcp-server).
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 25 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 78/100
  - 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).
  - AI-judged instruction clarity (good).
  - Context-footprint check failed: tool/resource definitions use about 1294 tokens (~143/item across 9 items; 8 tools + 1 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 23/100
  - Stability observed for 7 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 94/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 82% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a current MCP spec version (2026-07-28).

## Install

### Claude

```bash
claude mcp add mattmohandiss-cad-mcp-server -- npx -y cad-mcp-server
```

### Codex

```bash
codex mcp add mattmohandiss-cad-mcp-server -- npx -y cad-mcp-server
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "mattmohandiss-cad-mcp-server": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "cad-mcp-server"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add mattmohandiss-cad-mcp-server --command npx --arg -y --arg cad-mcp-server
```

### Hermes

```yaml
mcp_servers:
  mattmohandiss-cad-mcp-server:
    command: "npx"
    args: ["-y", "cad-mcp-server"]
```

### Other

```json
{
  "mcpServers": {
    "mattmohandiss-cad-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "cad-mcp-server"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-02 (score 77, +16)

- [security improvement] Malware scan: unverified → pass
- [functional improvement] Stability: unverified → 0.20
- [functional] MCP protocol: Implements a current MCP spec version (2026-07-28).

### 2026-07-31 (score 61, −10)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-30 (score 71, −18)

- [security regression] Malware scan: pass → unverified

### 2026-07-27 (score 89, +33)

- [functional improvement] Tool coverage: unverified → 100
- [functional improvement] Schema quality: unverified → 100
- [functional] First check of Schema quality: fail
- [functional] First check of Schema quality: fail
- [functional] First check of Schema quality: good
- [functional] First check of Tool coverage: 82

### 2026-07-26 (score 56)

First indexed and scored.

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

## MCP tools (8)

### `inspect_step` (~91 tokens)

Use this FIRST for a compact model overview: dimensions, bounding box, body/face/edge counts, validity, watertight status. Use include[] for bodies, quality, pmi, inertia, or topology detail.

Input parameters:

- `file_path` (string, required): Path to STEP file on local filesystem.
- `include` (array): Detail presets. Default: size, counts, health. Add more for detailed analysis.

### `find_faces` (~129 tokens)

Find faces by type, area, radius, normal, quality, or body. Returns IDs, surface types, areas, radii, diameters, axes, normals. Use returned IDs in measure_distance, measure_thickness, measure_draft, or measure_geometry.

Input parameters:

- `file_path` (string, required): Path to STEP file on local filesystem.
- `filters` (object)
- `include` (array): Result detail presets. Omit for basic face identity, area, bounds, and adjacency.
- `max_results` (integer)
- `sort` (string)
- `summarize` (object)

### `find_edges` (~98 tokens)

Find edges by curve type, length, radius, or dihedral angle. Returns IDs, curve types, lengths, radii, diameters. Use returned IDs in measure_distance or measure_geometry.

Input parameters:

- `file_path` (string, required): Path to STEP file on local filesystem.
- `filters` (object)
- `include` (array)
- `max_results` (integer)
- `sort` (string)
- `summarize` (object)

### `measure_distance` (~178 tokens)

Measure distance between entity sets. Pass sources[] and targets[] for set-based measurement (e.g. clearance between holes and walls). Use summary="minimum" for the closest pair only.

Input parameters:

- `entity_ids` (array): Source entity IDs (legacy mode with target_entity_id). Prefer sources/targets for set mode.
- `file_path` (string, required): Path to STEP file on local filesystem.
- `include_extrema` (boolean): Include closest point pairs with coordinates.
- `sources` (array): Source entity IDs for set-based distance. Use with targets for clearance checks.
- `summary` (string): all = return every pair; minimum = return only the closest pair.
- `target_entity_id` (string): Single target entity ID. Use when sources is omitted with entity_ids.
- `targets` (array): Target entity IDs for set-based distance.

### `measure_thickness` (~172 tokens)

Measure wall thickness across faces via ray grid sampling. Returns min/max/avg thickness per face. Use direction_mode="normal" (default) or direction_mode="axis".

Input parameters:

- `bidirectional` (boolean): Fire rays in both directions. Default true for thickness.
- `detail` (string): stats = min/max/avg only; samples = include hit coordinates.
- `direction` (array): Ray direction [x,y,z]. Mutually exclusive with direction_mode.
- `direction_mode` (string): Direction shortcut. axis = along the face axis; normal = along the face normal.
- `faces` (array, required): Face IDs to measure wall thickness across.
- `file_path` (string, required): Path to STEP file on local filesystem.
- `spacing_mm` (number): Grid spacing in mm. Smaller = denser sampling.

### `measure_draft` (~122 tokens)

Measure draft angles of faces relative to a pull direction. Returns draft_angle_deg, normal, and undercut flag per face. Positive = good for ejection; negative = undercut.

Input parameters:

- `faces` (array, required): Face IDs to check draft angle on.
- `file_path` (string, required): Path to STEP file on local filesystem.
- `pull_direction` (array): Pull direction [x,y,z]. Mutually exclusive with pull_direction_mode.
- `pull_direction_mode` (string): Direction shortcut. axis = along the face axis; normal = along the face normal.

### `measure_geometry` (~407 tokens)

Ray tests, point analysis, cross-sections, and edge continuity. measurement_type selects the operation: ray, ray_grid, point_analysis, section, or continuity.

Input parameters:

- `analyze` (string): Section analysis mode. edge_count = count and describe edges; thickness = measure section thickness.
- `bidirectional` (boolean): Fire rays in both directions. Used by ray_grid.
- `checks` (array): Checks to perform at each point. Required for point_analysis.
- `detail` (string): stats = min/max/avg; samples = hit coordinates; hits = full grid results.
- `direction` (array): Ray direction [x,y,z]. Used by ray, ray_grid.
- `direction_mode` (string): Direction shortcut. axis = along entity axis; normal = along entity normal.
- `entity_ids` (array, required): Entity IDs from find_faces/find_edges or inspect_step bodies.
- `file_path` (string, required): Path to STEP file on local filesystem.
- `max_distance` (number): Maximum ray distance mm. If set, ray becomes bounded (ray_test_segment).
- `measurement_type` (string, required): ray = single ray from origin in direction; ray_grid = grid of rays across entity; point_analysis = classify/project/curvature at points; section = planar cross-section; continuity = edge smoothness b…
- `origin` (array): Ray origin [x,y,z]. Used by ray. Mutually exclusive with origin_mode.
- `origin_mode` (string): Origin shortcut relative to entity bounding box. Used by ray.
- `plane_normal` (array): Normal of cutting plane. Required for section.
- `plane_origin` (array): Point on cutting plane. Required for section.
- `points` (array): 3D points to analyze. Required for point_analysis.
- `spacing_mm` (number): Grid spacing mm. Used by ray_grid. Default 2.
- `tolerance` (number): Tolerance mm for point checks. Default 0.01.

### `diff_step` (~62 tokens)

Compare two STEP files. Returns deltas: volume, surface area, dimensions, face/edge/body counts. Comparison minus baseline.

Input parameters:

- `baseline_file_path` (string, required): Path to baseline STEP file.
- `comparison_file_path` (string, required): Path to comparison STEP file.

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/mattmohandiss-cad-mcp-server/cad-mcp-server#diagnostics

## Score history

- 2026-08-03: 77
- 2026-08-02: 77
- 2026-08-01: 61
- 2026-07-31: 61
- 2026-07-30: 71
- 2026-07-28: 89
- 2026-07-27: 89
- 2026-07-26: 56

## Links

- npm package: https://www.npmjs.com/package/cad-mcp-server
- Socket report: https://socket.dev/npm/package/cad-mcp-server
- Repository: https://github.com/mattmohandiss/cad-mcp-server
- Changelog RSS feed: https://verifymcp.io/servers/mattmohandiss-cad-mcp-server/cad-mcp-server/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/mattmohandiss-cad-mcp-server/cad-mcp-server/changelog.json
- HTML version of this page: https://verifymcp.io/servers/mattmohandiss-cad-mcp-server/cad-mcp-server