# dev.glbforge/glbforge (npm · @glbforge/mcp)

Make AI-generated 3D assets web-ready: analyze budgets, optimize, forge logos to 3D, export STL.

- Trust score: 63/100 (medium)
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-20

## Components

- npm · `@glbforge/mcp`: 63/100 (this document), [markdown](https://verifymcp.io/servers/dev-glbforge-glbforge/glbforge-mcp.md), [page](https://verifymcp.io/servers/dev-glbforge-glbforge/glbforge-mcp)

## Channel facts

- Registry: `npm`
- Package: `@glbforge/mcp`
- Version: `0.3.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-20.

- **Supply Chain Security**: 49/100
  - Malware scan not yet available for this package.
  - No known CVEs affecting this package version or its production dependencies.
  - No install/post-install scripts declared.
  - 38 of 146 dependencies flagged as unhealthy.
- **Provenance & Transparency**: 97/100
  - Source repository is publicly reachable at the declared URL.
  - Cryptographically verified build provenance (signed, bound to glbforge/glbforge).
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 0 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 73/100
  - AI-judged instruction clarity (good).
  - Context-footprint check failed: tool/resource definitions use about 1065 tokens (~133/item across 8 items; 8 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 88/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 64% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

**Unverified: 1 category.** A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

## Install

### Claude

```bash
claude mcp add dev-glbforge-glbforge -- npx -y @glbforge/mcp
```

### Codex

```bash
codex mcp add dev-glbforge-glbforge -- npx -y @glbforge/mcp
```

### opencode

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

### OpenClaw

```bash
openclaw mcp add dev-glbforge-glbforge --command npx --arg -y --arg @glbforge/mcp
```

### Hermes

```yaml
mcp_servers:
  dev-glbforge-glbforge:
    command: "npx"
    args: ["-y", "@glbforge/mcp"]
```

### Other

```json
{
  "mcpServers": {
    "dev-glbforge-glbforge": {
      "command": "npx",
      "args": [
        "-y",
        "@glbforge/mcp"
      ]
    }
  }
}
```

## 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-20 (score 63)

First indexed and scored.

## MCP tools (8)

### `list_profiles` (~23 tokens)

List the available web performance budget profiles (triangle/texture/file-size caps).

### `analyze_glb` (~91 tokens)

Analyze a GLB/glTF file against a web performance budget. Returns a score, budget pass/fail, geometry+texture stats, and named lint findings with fixes. Run this before and after any optimization.

Input parameters:

- `path` (string, required): Absolute path to the .glb file
- `profile` (string)
- `topology` (boolean): Run the (slower) weld/edge topology pass

### `optimize_glb` (~186 tokens)

Optimize a GLB for web delivery: weld, simplify to the profile triangle budget, fill smooth normals, resize/re-encode textures to WebP, meshopt-compress. Writes the optimized file and returns a before/after diff. Typically 90%+ smaller.

Input parameters:

- `compress` (boolean)
- `lods` (array): Extra LOD triangle targets, e.g. [40000, 10000]
- `out` (string): Output path (default: <input>.web.glb)
- `path` (string, required): Absolute path to the input .glb
- `profile` (string)
- `targetTriangles` (integer)
- `textureFormat` (string): webp = smallest file; ktx2 = GPU-resident compression, ~8x less video memory (needs basisu/toktx installed)
- `textures` (boolean)

### `extrude_image` (~346 tokens)

Deterministic 2D graphic -> extruded 3D GLB (no AI, no credits, instant). Traces the image silhouette and projects the source image back on as texture. USE THIS instead of Meshy generation for flat artwork: logos, wordmarks, icons, stickers. Use Meshy for photographic or dimensional subjects. Supports a signage-style bevel on the rims.

Input parameters:

- `bevel` (number): Bevel radius in meters (signage look; try depth*0.25)
- `bevelSegments` (integer)
- `color` (string): Hex color when texture=false, e.g. "#ff2266"
- `depth` (number): Extrusion depth in meters (default width*0.08)
- `layers` (integer): Layered color extrusion: quantize into N color layers at stepped depths (the "layered acrylic" look)
- `metallic` (number)
- `mode` (string): Solid-pixel test: alpha (transparent bg) | luma (white bg). Auto-detected.
- `out` (string, required): Absolute output path for the .glb
- `path` (string, required): Absolute path to a PNG/JPEG/WebP with transparent or white background
- `pillow` (number): Puffy-sticker dome height in meters (e.g. 0.04); supersedes bevel
- `preset` (string): Material preset for the forged piece
- `roughness` (number)
- `simplify` (number): Contour tolerance in trace pixels
- `texture` (boolean): Project source image as baseColor
- `threshold` (integer)
- `width` (number): World width in meters

### `export_stl` (~101 tokens)

Export a GLB as binary STL for 3D printing — scaled to millimeters, rotated z-up. Reports watertightness (glbforge-extruded assets are watertight by construction; simplified AI meshes usually are too).

Input parameters:

- `out` (string, required): Absolute output path for the .stl
- `path` (string, required): Absolute path to the .glb
- `sizeMm` (number): Largest printed dimension in millimeters

### `meshy_create_task` (~222 tokens)

Start a Meshy generation task (needs MESHY_API_KEY). kind "image-to-3d" takes a local image path or URL; kind "text-to-3d" takes a prompt (geometry preview stage — pass refine_from to texture a finished preview). Returns a task id immediately; poll meshy_task_status (generation takes minutes).

Input parameters:

- `enable_pbr` (boolean)
- `image` (string): image-to-3d: local path or http(s) URL
- `input_task_id` (string): remesh/retexture: the SUCCEEDED task to operate on
- `kind` (string, required)
- `prompt` (string): text-to-3d: what to generate; retexture: the style prompt
- `refine_from` (string): text-to-3d: preview task id to refine (texture stage)
- `should_texture` (boolean): image-to-3d: run the texture stage
- `target_polycount` (integer)
- `topology` (string): remesh: output topology

### `meshy_task_status` (~43 tokens)

Check a Meshy task: status, progress %, and (when finished) model URLs.

Input parameters:

- `kind` (string, required)
- `taskId` (string, required)

### `meshy_download` (~53 tokens)

Download a finished Meshy task's GLB to a local path.

Input parameters:

- `kind` (string, required)
- `out` (string, required): Absolute output path for the .glb
- `taskId` (string, required)

## Diagnostics

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

## Score history

- 2026-08-20: 63

## Links

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