# Thicken

> Thicken is an open-source MCP server for design and media. Turn photos of a book, card or badge into a real-size 3D model plus JSON metadata. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/bikemeardsley/thicken
- **MCP Registry name:** io.github.bikemeardsley/thicken
- **Categories:** [design and media](https://ai-powered.com/categories/design-and-media)
- **Listing updated:** 2026-11-18

## About

Each run writes a GLB model sized in millimetres and a JSON sidecar that records what the object is. The sidecar is built from codes on the object, such as an ISBN barcode or a grader's QR code, public catalogs, and optionally vision models that read printed text. For a graded card slab it can capture the grader, cert number, grade, signer and set; for a book, the catalog record with title, authors, publishers and subjects.

What it knows about each kind of object lives in a profile. Bundled profiles cover books, single cards, graded slabs, boxes, badges and puffy 3D lettering, and you can add your own. The README says it is not photogrammetry: it builds geometry from known sizes and maps your photos onto it.

It is a Node 22.18+ command-line tool and library that also runs as an MCP server over stdio. Uncropped or angled photos and video need an OpenAI-compatible vision endpoint.

## Features

- **Real-size GLB output:** Models are built in millimetres from known object sizes.
- **Metadata sidecar:** JSON with identification, catalog data and how each fact was found.
- **Profiles per object:** Bundled profiles for book, card, slab, box, badge and lettering.
- **Code-based lookup:** Reads ISBN barcodes and grader QR codes; ISBN-only mode needs no photo.
- **Optional vision models:** Any OpenAI-compatible endpoint reads labels and printed text.
- **Batch mode:** Makes a model per photo, PDF, video or folder.

## Good for

- Build a 3D shelf of your books from cover photos
- Catalogue graded trading cards with cert numbers and grades
- Make extruded 3D versions of badge artwork
- Generate metadata for a collection from a photo folder
- Let an agent make a model of an object on your desk

## Install

### Claude Code (Terminal)

```sh
claude mcp add thicken --env THICKEN_VISION_KEY='<THICKEN_VISION_KEY>' --env GOOGLE_BOOKS_API_KEY='<GOOGLE_BOOKS_API_KEY>' -- npx -y thicken
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "thicken": {
      "command": "npx",
      "args": [
        "-y",
        "thicken"
      ],
      "env": {
        "THICKEN_VISION_KEY": "<THICKEN_VISION_KEY>",
        "GOOGLE_BOOKS_API_KEY": "<GOOGLE_BOOKS_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "thicken": {
      "command": "npx",
      "args": [
        "-y",
        "thicken"
      ],
      "env": {
        "THICKEN_VISION_KEY": "<THICKEN_VISION_KEY>",
        "GOOGLE_BOOKS_API_KEY": "<GOOGLE_BOOKS_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "thicken": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "thicken"
      ],
      "env": {
        "THICKEN_VISION_KEY": "<THICKEN_VISION_KEY>",
        "GOOGLE_BOOKS_API_KEY": "<GOOGLE_BOOKS_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "thicken": {
      "command": "npx",
      "args": [
        "-y",
        "thicken"
      ],
      "env": {
        "THICKEN_VISION_KEY": "<THICKEN_VISION_KEY>",
        "GOOGLE_BOOKS_API_KEY": "<GOOGLE_BOOKS_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "thicken": {
      "command": "npx",
      "args": [
        "-y",
        "thicken"
      ],
      "env": {
        "THICKEN_VISION_KEY": "<THICKEN_VISION_KEY>",
        "GOOGLE_BOOKS_API_KEY": "<GOOGLE_BOOKS_API_KEY>"
      }
    }
  }
}
```

## FAQ

### How do I run it as an MCP server?

Use npx -y thicken mcp on stdio, or install the Claude Code plugin from the bikemeardsley/thicken marketplace.

### Do I need a vision model?

Only for uncropped photos, angled shots and video, or to read labels. Cropped straight-on photos work as they are.

### What are the requirements?

Node 22.18 or later.

### Can I add other kinds of object?

Yes. Each profile is one file in src/profiles and the README invites contributions.

### Is Thicken free?

Yes. Thicken is open source, so you can use and self-host it for free.

### How do I add Thicken to Claude Code?

Run this command in your terminal: claude mcp add thicken --env THICKEN_VISION_KEY='<THICKEN_VISION_KEY>' --env GOOGLE_BOOKS_API_KEY='<GOOGLE_BOOKS_API_KEY>' -- npx -y thicken

### What are the best alternatives to Thicken?

The closest alternatives to Thicken are HyperFrames by HeyGen, next-ai-draw-io, mcp-for-blender, ffmpeg-skill and cursor-talk-to-figma-mcp.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [next-ai-draw-io](https://ai-powered.com/mcp/next-ai-draw-io-2): next-ai-draw-io is an open-source MCP server for ai models and llm tooling.
- [mcp-for-blender](https://ai-powered.com/mcp/mcp-for-blender): mcp-for-blender is an open-source MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [cursor-talk-to-figma-mcp](https://ai-powered.com/mcp/cursor-talk-to-figma-mcp): cursor-talk-to-figma-mcp is an open-source MCP server for design and media.
- [Design Feeds](https://ai-powered.com/mcp/design-feeds): Design Feeds is a freemium MCP server for design and media.
- [Meigen AI MCP](https://ai-powered.com/mcp/meigen-ai-mcp): Meigen AI MCP is an open-source MCP server for design and media.
- [Z-Image MCP](https://ai-powered.com/mcp/z-image-mcp): Z-Image MCP is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/thicken
