# Quady3D MCP

> Quady3D MCP is a freemium MCP server for design and media. Generate 3D models from text or images and save the files into your project. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $11.99 a month
- **Platforms:** CLI, API, self-hosted
- **Website:** https://quady3d.com/integrations/mcp
- **Repository:** https://github.com/quady3dai/quady3d-tools/tree/HEAD/packages/mcp
- **MCP Registry name:** io.github.quady3dai/mcp
- **Categories:** design and media
- **Listing updated:** 2026-11-14

## About

Quady3D MCP is the official local server from Quady3D AI. It gives a coding agent eight tools for the Quady3D cloud service: list models, check the account, upload one image, price a job, start it, follow it, list past jobs and download the finished asset. The README says it has been verified with Codex CLI on macOS; Claude Code and Claude Desktop are marked unverified for this release.

Cost control is built into the flow. A quote does not generate anything, a created job reserves credits within a limit you authorise, and API keys can carry small per-job and daily limits and an expiry. If a submission is interrupted, the agent queries the existing job rather than creating a replacement. Downloads are written only inside project folders you pass with `--root`, and existing files are not overwritten.

You need Node.js 22+, a Quady3D account with credits, and a key with Generate and download permissions. Image input is one PNG, JPEG or WebP up to 8 MiB.

## Features

- **Eight workflow tools:** Covers models, account, upload, quote, job creation, job status, job list and download.
- **Quote before spending:** Prices an input without starting generation; quotes expire after five minutes.
- **Task recovery:** Look up an earlier job by ID instead of creating a duplicate.
- **Folder-scoped saves:** Writes model files only inside allowed project roots and never replaces files.
- **Limited keys:** Keys can be restricted to inspection, or to generation with per-job and daily caps.

## Good for

- Generate a GLB asset for a game project from a text prompt
- Turn a reference image into a 3D model and save it in the repo
- Check credit balance and download access before a batch
- Resume a generation task after a dropped connection

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp --env QUADY3D_API_KEY='<QUADY3D_API_KEY>' --env QUADY3D_ALLOWED_ROOTS='<QUADY3D_ALLOWED_ROOTS>' -- npx -y @quady3d/mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@quady3d/mcp"
      ],
      "env": {
        "QUADY3D_API_KEY": "<QUADY3D_API_KEY>",
        "QUADY3D_ALLOWED_ROOTS": "<QUADY3D_ALLOWED_ROOTS>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@quady3d/mcp"
      ],
      "env": {
        "QUADY3D_API_KEY": "<QUADY3D_API_KEY>",
        "QUADY3D_ALLOWED_ROOTS": "<QUADY3D_ALLOWED_ROOTS>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@quady3d/mcp"
      ],
      "env": {
        "QUADY3D_API_KEY": "<QUADY3D_API_KEY>",
        "QUADY3D_ALLOWED_ROOTS": "<QUADY3D_ALLOWED_ROOTS>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@quady3d/mcp"
      ],
      "env": {
        "QUADY3D_API_KEY": "<QUADY3D_API_KEY>",
        "QUADY3D_ALLOWED_ROOTS": "<QUADY3D_ALLOWED_ROOTS>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@quady3d/mcp"
      ],
      "env": {
        "QUADY3D_API_KEY": "<QUADY3D_API_KEY>",
        "QUADY3D_ALLOWED_ROOTS": "<QUADY3D_ALLOWED_ROOTS>"
      }
    }
  }
}
```

## Tools

- `quady3d_list_models`: Lists available models, inputs and parameters.
- `quady3d_get_account`: Shows balance, download access, key limits and project readiness.
- `quady3d_upload_file`: Uploads one selected PNG, JPEG or WebP image.
- `quady3d_quote`: Prices an input without starting generation.
- `quady3d_create_job`: Submits a generation job within the authorised credit limit.
- `quady3d_get_job`: Checks or waits on the original task.
- `quady3d_list_jobs`: Finds the account's API tasks.
- `quady3d_download_asset`: Saves an owned result into the project without replacing files.

## FAQ

### What does it cost?

The client is MIT licensed. Generation uses Quady3D credits; the site lists Basic at $11.99 a month, Creator at $29.99 and Studio at $119, plus one-time credit packs, and 30 free credits once after email verification.

### Where is the key stored?

In `~/.config/quady3d/connection.json` with private permissions, or in the `QUADY3D_API_KEY` environment variable. It is not encrypted keychain storage.

### Which clients are verified?

Codex CLI on macOS. Claude Code and Claude Desktop are listed as unverified.

### Can free accounts download models?

Full AI model downloads need a credit pack or subscription, according to the pricing page.

### Is Quady3D MCP free?

Quady3D MCP has a free plan, with paid plans for more usage or features. Paid plans start at $11.99 a month.

### How do I add Quady3D MCP to Claude Code?

Run this command in your terminal: claude mcp add mcp --env QUADY3D_API_KEY='<QUADY3D_API_KEY>' --env QUADY3D_ALLOWED_ROOTS='<QUADY3D_ALLOWED_ROOTS>' -- npx -y @quady3d/mcp

### What are the best alternatives to Quady3D MCP?

The closest alternatives to Quady3D MCP are HyperFrames by HeyGen, ffmpeg-skill, AvatarSay — Fictional Character & Talking Video MCP, ChartAnt and VfxSmith.

## Alternatives

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium 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.
- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [Eikino](https://ai-powered.com/mcp/eikino): Eikino is a freemium MCP server for security.
- [Hourlore](https://ai-powered.com/mcp/hourlore): Hourlore is a freemium MCP server for design and media.

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