PicoBerry

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/umodeler-picoberry-mcp

About

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.

Tools

6 read · 2 write · 0 delete · 6 not yet classified

Secrets

1 (API keys, tokens or passwords)

Install scripts

None found

Runs as

Node.js package

Tools (14)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

• animate

  Auto-rig an existing 3D character asset and apply an animation, producing a NEW asset (async). Pick `preset` from list_animation_presets for the SAME engine. Costs credits — see list_models(category='animate'). wait_for_asset → files.model.

• download_asset

  Export a completed 3D asset and get a short-lived signed download URL. glb = a single self-contained file. fbx/obj download as a .zip bundle (model + textures; + Unity .meta files when texture_preset='unity') — unzip before importing. For Unity use fbx (there is no built-in glb importer).

• generate_3d_from_image

  Generate a 3D model (GLB) from one image, or from 2–4 views of the same subject (multi-view → higher-fidelity geometry), async. Single: `image_url` (any public http/https image, or a prior generation's files.image) OR `image_path` (a local file, uploaded directly — no hosting needed). Multi-view: `image_urls` OR `image_paths`, ordered [front, left, back, right] (2–4 views). Not every engine takes multi-view — check `supportsMultiView` from list_models(category='image-to-3d'); unsupported engines return 400. Local files win over URLs. Then wait_for_asset and read files.model. Costs credits — se…

• generate_3d_from_text

  Generate a game-ready 3D model (GLB) from a text prompt (async). Returns an asset { id }; call wait_for_asset (or poll get_asset) until taskStatus=2 and read files.model (GLB URL). Costs credits — see list_models(category='3d'). Omit `engine` for the default.

• generate_image

  Generate a 2D image from a text prompt (async). Returns an asset { id }; then call wait_for_asset (or poll get_asset) until taskStatus=2 and read files.image (PNG URL). Costs credits — see list_models(category='image'). Omit `model` for the default. Up to 4 reference image URLs can guide the result (best with nano-banana). Set `count` (1–4) for several images from one call: the top-level fields stay the first image and `assets[]` lists every image (same batchId) — wait_for_asset on each id. Each image is billed separately; if the balance can't cover all of them nothing is charged. A count abov…

• get_asset

  Get a generation's status + result. taskStatus: 0=pending 1=processing 2=succeeded 3=failed. When succeeded, files.{model,image,thumbnail,textures} hold signed result URLs (short TTL — download promptly). On failure, read errorDetail.

• get_credits

  Get the current PicoBerry credit balance for the authenticated key.

• list_animation_presets

  List animation preset ids for the `animate` tool. Presets are engine-specific (Tripo ~97 / Meshy ~675) — pick one from the SAME engine you animate with. Optionally filter with a case-insensitive substring.

• list_models

  List available generation engines/models and their credit cost for a category. Call this before generating instead of hardcoding engine names. Returns [{ name, label, cost, paidOnly, supportsMultiView, supportsUltraMode, ultraCost, ... }] — use `name` as the engine/model value. NOTE: the two 3D surfaces are SEPARATE catalogs — `3d` is text-to-3D, `image-to-3d` is image-to-3D. An unrecognized category silently falls back to `3d`, so a guessed value returns a plausible list that is missing image-only engines.

• list_my_assets

  List your generated assets (newest first, owner-scoped) for browsing/sync. Filter by category (3d/image/…) or keyword.

• parts_board

  Decompose one reference image into an exploded "parts board" image (async) — the subject laid out as separated components on one canvas. Input: `asset_id` (an existing IMAGE asset you own), `image_url` (a public http/https image), OR `image_path` (a local file, uploaded directly). Engine/resolution/prompt are server-fixed — no params. Returns an asset { id }; call wait_for_asset (or poll get_asset) until taskStatus=2 and read files.image (the board PNG). Feed that image to generate_3d_from_image for a parts-separated mesh. Costs 80 credits — see list_models(category='parts-board'). Precedence …

• remesh

  Retopologize an existing 3D asset into a NEW asset (async). Costs credits — see list_models(category='remesh') (pb-remesh is cheapest). wait_for_asset → files.model.

• texture

  Re-texture an existing 3D asset (PBR) into a NEW asset (async). Describe the desired look in `prompt`. Costs credits — see list_models(category='texture'). wait_for_asset → files.model.

• wait_for_asset

  Poll an asset until it finishes (taskStatus 2 or 3) or the timeout elapses, then return the final asset. Use right after generate_* / remesh / texture / animate. 3D generations can take several minutes.

Signals

Stars

2

Forks

0

Open issues

1

Last commit

Oct 20, 2026 (9 days ago)

Last release

Oct 22, 2026 (7 days ago)

From GitHub (fetched Oct 24, 2026).

Details

Registry name

io.github.UModeler/picoberry-mcp

Version

0.1.7

Auth

API key

Packages

npm @picoberry/mcp-server

License

MIT

Repository

github.com/UModeler/picoberry-mcp

Website

picoberry.ai

First seen

Oct 24, 2026

Last checked

Oct 24, 2026

Source

Official MCP Registrygithub-graphql