PicoBerry

by umodeler

Not rated
GitHub

About

Generate 3D models and images from a text prompt or reference images, then remesh, retexture, auto-rig, animate, and export GLB/FBX/OBJ.

Details

Author
umodeler
Categories
Design

Setup

Install PicoBerry in your MCP client (Claude Desktop, Cursor, Windsurf, and others).

Repository: https://github.com/umodeler/picoberry-mcp

Follow the installation instructions in the repository README, then restart your MCP client.

Generate3D models, images, and animationsfor game and 3D workflows from any MCP client — Claude Code, Cursor, Claude Desktop, Cline — with no HTTP glue. A thin wrapper over thePicoBerry/v1API, so you get PicoBerry's multi-engine pipeline directly inside your agent. Several 3D and image engines sit behind one API; calllist_modelsfor the live set and each engine's cost. Generated assets are drafts — useful for prototyping and iteration, and can be reviewed or refined for your project.

📖Full reference:API + MCP docs·PicoBerry API

There's no separate subscription for the MCP or the API.Generation spends the same prepaid PicoBerry credits as the web app, per engine, at rates you can read withlist_modelsbefore you spend anything. (Using the API does require a completed purchase — seeGet an API key.)

// Claude Code: .mcp.json · Claude Desktop: claude_desktop_config.json { "mcpServers": { "picoberry": { "command": "npx", "args": ["-y", "@picoberry/mcp-server"], "env": { "PICOBERRY_API_KEY": "pb_live_xxxxxxxxxxxxxxxx" } } } }

Cursor uses the same shape in~/.cursor/mcp.json.

API access needs a completed purchase: a subscriptionor a one-off credit pack. A purchase entitles you permanently — you don't need acurrentsubscription. (An active paid subscription works too, of course.)
- generate_3d_from_text({ prompt })→ returns an asset{ id }.
- wait_for_asset({ asset_id: id })→ polls untiltaskStatus === 2(succeeded).
- Read the result URL fromfiles.model(GLB) orfiles.image(PNG).

taskStatus:0pending ·1processing ·2succeeded ·3failed. Result URLs are signed and short-lived — download promptly. Errors come back with an actionable message (e.g. an unknown engine returns the list of valid names).

"Make a low-poly treasure chest, retopo it to 3k tris, and give me a Unity FBX."

list_models(category="3d") → pick an engine generate_3d_from_text(prompt="low-poly treasure chest") → { id: A } wait_for_asset(asset_id=A) → taskStatus 2 remesh(asset_id=A, polycount=3000) → { id: B } wait_for_asset(asset_id=B) download_asset(asset_id=B, format="fbx", texture_preset="unity") → signed URL

Run this next toblender-mcpand the agent can generate with PicoBerry, then import into Blender in one flow:

{ "mcpServers": { "picoberry": { "command": "npx", "args": ["-y", "@picoberry/mcp-server"], "env": { "PICOBERRY_API_KEY": "pb_live_..." } }, "blender": { "command": "uvx", "args": ["blender-mcp"] } } }
npm install npm run build # tsc → dist/ PICOBERRY_API_KEY=pb_live_... npm start

RunActions → Publish → Run workflow(or push avtag). It publishes to npm and then to the official MCP registry, in that order — the registry validates by fetching the package's npm metadata and matching itsmcpNameagainstserver.json'sname, so npm has to land first. A guard step checks every invariant (name/version agreement, namespace casing, version not already on npm)beforeanything is published, because npm versions are immutable and a failed half-publish burns the number.

Bumpversioninbothpackage.jsonandserver.json(versionandpackages[0].version) — the guard fails the run if they disagree.

One-time setup — no secrets.Both publishes authenticate over the workflow's GitHub OIDC token (id-token: write). There is nothing to store or rotate.

The only step is telling npm to trust this workflow. On npmjs.com go to@picoberry/mcp-server → Settings → Trusted publishing → GitHub Actionsand enter:

The workflow filename must match exactly — it is part of what npm verifies.

The MCP registry needs no setup at all:mcp-publisherexchanges the Actions OIDC token, and the registry grantsio.github.<repository_owner>/from the token'srepository_ownerclaim. That coversio.github.UModeler/picoberry-mcpand avoids the interactive browser login (which additionally requires org Owner).

Trusted Publishing needsnpm >= 11.5.1, so the workflow runs onNode 24(npm 11.x). Node 22 still bundles npm 10.9 and would fail — thenode-versionpin is load-bearing. A guard step fails the run early if the runner ever ships an older npm.

The namespace is comparedbyte-exactlyio.github.UModeler/..., matching the GitHub org's login. A lowercasedio.github.umodeler/...is rejected 403.

After publishing, claim theGlama listing— unclaimed servers get limited discoverability, andawesome-mcp-serversgates its PRs on a Glama badge in CI.

A lightweight MCP (Model Context Protocol) server for Blender. It offers a natural language interface with Blender’s Python API, improving access to documentation, and allowing users to explore and understand complex setups.

The Lottie Creator MCP brings your AI assistant directly into your animation workflow — giving it full access to LottieFiles Creator so it can build and edit Lottie animations on your behalf through natural language.

AI Video, Image & Audio Generation with over 150 models

Rive MCP let AI handle repetitive tasks, like creating complex View Models, State Machines with hundreds of states/layers, Layouts, Shapes, and more.

Create, edit, and export SVGator animations (SVG, Lottie, GIF, video) from your AI assistant, and keep an editable project you can open in the editor anytime.

You're agent can Chain 60+ AI image and video models on one workflow canvas

Real interaction references and motion recipes for AI coding agents.

Search 1,145 real website designs by style, font, colour, section and measured design tokens.

Render, verify, describe, and safely edit Mermaid diagrams through MCP.

MCP bridge between an AI agent and a live Aseprite session, same machine or agent-in-a-VM

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.