# PicoBerry

> PicoBerry is a freemium MCP server for design and media. Generate, remesh, texture and animate 3D models and images from your agent. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $12 a month
- **Platforms:** CLI, API
- **Website:** https://picoberry.ai
- **Repository:** https://github.com/umodeler/picoberry-mcp
- **MCP Registry name:** io.github.UModeler/picoberry-mcp
- **Categories:** design and media
- **Listing updated:** 2026-11-15

## About

PicoBerry's server is a thin wrapper over its /v1 API, so an agent can drive the same multi-engine 3D pipeline as the web app. Generation is asynchronous: a tool starts a job and the agent waits on the asset until it finishes, then downloads it as GLB, FBX or OBJ through a signed URL.

The README tells agents to call list_models before generating rather than hardcoding engines, because the engine set and per-engine credit costs change. Multi-view image-to-3D takes two to four views ordered front, left, back, right, but only for the Tripo, Meshy 6 and Hunyuan 3.x engines. Auto-rigging covers humanoids on Tripo and Meshy, while PicoBerry's own rig also handles quadrupeds (rig only for now). Output is described as draft quality for prototyping.

The server runs locally over stdio with npx and needs an API key. There is no separate MCP subscription: generation spends the same prepaid credits as the web app, and an API key requires a completed purchase.

## Features

- **Text and image to 3D:** Create GLB models from a prompt or from one to four views.
- **Image generation:** Make one to four images per call, with optional reference images.
- **Remesh and texture:** Retopologize or re-texture an existing asset with PBR.
- **Rigging and animation:** Auto-rig humanoids, and quadrupeds with PicoBerry's rig.
- **Parts board:** Break an image into an exploded parts board before building a mesh.
- **Export formats:** Download finished assets as GLB, FBX or OBJ.

## Good for

- Fill a game prototype with props and characters
- Retopologize a generated mesh for an engine
- Rig a character and add an animation preset
- Check credit cost across engines before spending

## Install

### Claude Code (Terminal)

```sh
claude mcp add picoberry-mcp --env PICOBERRY_API_KEY='<PICOBERRY_API_KEY>' -- npx -y @picoberry/mcp-server
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "picoberry-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@picoberry/mcp-server"
      ],
      "env": {
        "PICOBERRY_API_KEY": "<PICOBERRY_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "picoberry-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@picoberry/mcp-server"
      ],
      "env": {
        "PICOBERRY_API_KEY": "<PICOBERRY_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "picoberry-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@picoberry/mcp-server"
      ],
      "env": {
        "PICOBERRY_API_KEY": "<PICOBERRY_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "picoberry-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@picoberry/mcp-server"
      ],
      "env": {
        "PICOBERRY_API_KEY": "<PICOBERRY_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "picoberry-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@picoberry/mcp-server"
      ],
      "env": {
        "PICOBERRY_API_KEY": "<PICOBERRY_API_KEY>"
      }
    }
  }
}
```

## Tools

- `list_models`: Engines and credit cost for a category.
- `list_animation_presets`: Animation preset ids per engine family.
- `get_credits`: Current credit balance.
- `generate_image`: Text to image with optional reference images.
- `generate_3d_from_text`: Text to 3D model (GLB).
- `generate_3d_from_image`: Image or multi-view images to a 3D model.
- `parts_board`: Decompose an image into an exploded parts board.
- `remesh`: Retopologize an existing 3D asset.
- `texture`: Re-texture an existing asset with PBR.
- `animate`: Auto-rig and optionally animate an existing asset.
- `get_asset`: Status and result URLs for one asset.
- `wait_for_asset`: Poll until an asset finishes.
- `list_my_assets`: Browse generated assets.
- `download_asset`: Export a completed asset as glb, fbx or obj.

## FAQ

### Do I need a subscription for the MCP?

No separate one; it spends the same credits as the web app, but an API key needs a completed purchase.

### How do I run it?

With npx -y @picoberry/mcp-server and a PICOBERRY_API_KEY.

### Which formats can I export?

GLB, FBX and OBJ.

### Is generation instant?

No, it is asynchronous and the agent waits on each asset.

### Is PicoBerry free?

PicoBerry has a free plan, with paid plans for more usage or features. Paid plans start at $12 a month.

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

Run this command in your terminal: claude mcp add picoberry-mcp --env PICOBERRY_API_KEY='<PICOBERRY_API_KEY>' -- npx -y @picoberry/mcp-server

### What are the best alternatives to PicoBerry?

The closest alternatives to PicoBerry 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/picoberry
