Skip to content
Open
2 changes: 1 addition & 1 deletion marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -1102,7 +1102,7 @@
"en": "Generate textured 3D models from text or images, add rigging and animation, simplify meshes, and export assets for games or 3D printing. Requires a mainland China Tripo account.",
"zh-CN": "用文字或图片生成带贴图的 3D 模型,添加骨骼与动画、精简模型面数,导出用于游戏或 3D 打印的素材。需使用 Tripo 国内站账号。"
},
"version": "0.1.4",
"version": "0.1.5",
"author": {
"name": "VAST",
"url": "https://www.tripo3d.ai"
Expand Down
8 changes: 4 additions & 4 deletions plugins/tripo-3d/.claude-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
{
"name": "tripo-3d",
"version": "0.1.3",
"description": "Generate textured, rig-ready 3D models from a text prompt or a reference image with Tripo, and export GLB/FBX/OBJ/STL/USDZ/3MF straight into your project. Connect your China-mainland Tripo account once in the browser (OAuth), no API key pasting.",
"version": "0.1.5",
"description": "Generate textured 3D models from text or images, add rigging and animation, simplify meshes, and export assets for games or 3D printing. Requires a mainland China Tripo account.",
"description_i18n": {
"en": "Generate textured, rig-ready 3D models from a text prompt or a reference image with Tripo, and export GLB/FBX/OBJ/STL/USDZ/3MF straight into your project. Connect your China-mainland Tripo account once in the browser (OAuth), no API key pasting.",
"zh-CN": "用 Tripo 从一句话或一张图生成带贴图、可绑骨的 3D 模型,支持动画、减面与 GLB/FBX/OBJ/STL/USDZ/3MF 导出,文件直接落到项目里。浏览器里授权一次国内站 Tripo 账号即可使用,无需粘贴 API Key。"
"en": "Generate textured 3D models from text or images, add rigging and animation, simplify meshes, and export assets for games or 3D printing. Requires a mainland China Tripo account.",
"zh-CN": "用文字或图片生成带贴图的 3D 模型,添加骨骼与动画、精简模型面数,导出用于游戏或 3D 打印的素材。需使用 Tripo 国内站账号。"
},
"author": {
"name": "VAST",
Expand Down
5 changes: 4 additions & 1 deletion plugins/tripo-3d/.mcp.json
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,10 @@
"type": "http",
"url": "https://developers.tripo3d.com/mcp",
"enabled": true,
"timeoutMs": 90000
"timeoutMs": 90000,
"headers": {
"X-Tripo-Distribution": "zcode_plugin"
}
}
}
}
2 changes: 1 addition & 1 deletion plugins/tripo-3d/.zcode-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "tripo-3d",
"version": "0.1.4",
"version": "0.1.5",
"description": "Generate textured 3D models from text or images, add rigging and animation, simplify meshes, and export assets for games or 3D printing. Requires a mainland China Tripo account.",
"description_i18n": {
"en": "Generate textured 3D models from text or images, add rigging and animation, simplify meshes, and export assets for games or 3D printing. Requires a mainland China Tripo account.",
Expand Down
111 changes: 72 additions & 39 deletions plugins/tripo-3d/README.md
Original file line number Diff line number Diff line change
@@ -1,25 +1,48 @@
# Tripo 3D

[中文](./README_CN.md)
[中文文档](./README_CN.md)

## 0.1.5

This plugin connects to the Tripo China site through its `tripo` MCP server.
It requires a Tripo mainland China account.

A user's explicitly chosen compatible model overrides usage-based defaults.
Choose from models that support the required features before applying the
scenario preference. If an explicitly chosen model conflicts with a required
feature, ask before changing the model or dropping the requirement.
Game/realtime recipes explicitly prefer **P2** (more credits than H/P1), the
P-series default; **P1** is used only when the user names it or picks it for lower
cost and speed, and v3.1 for film/render/print. Rigs pass the model
explicitly, v3.0 for bipeds and v2.5 for animals (the API's own default, v1.0,
rigs bipeds only), with animation presets selected
from the upstream rig model. Retopology v3.0's
`smart_uv` and standalone `tripo_smart_uv` are distinct billed workflows.
Fast textures require v3.5; `chat_image_1` is retired.

The plugin runs through the Tripo MCP tools only — there is no CLI path, and
missing authorization is never a reason to switch to one. PBR stays off unless
you explicitly ask for it. A plan is advisory, not a price quote or budget lock.
Show estimated or unestimated costs, cite the source, region and date of any
static list estimate, and obtain explicit consent. Never switch accounts silently.
The hook also provides the PBR default and explicit model/billing guidance.

The official Tripo plugin for ZCode. Generate textured 3D models from a text
prompt or a reference image, with rigging, animation, retopology and format
conversion (GLB/FBX/OBJ/STL/USDZ/3MF), and land the files directly in your
conversion (GLB/FBX/OBJ/STL/USDZ/3MF). You can ask to save the files in your
project. Built for games, film, AR and 3D printing.

Connect your **China-mainland** Tripo account once in the browser
(developers.tripo3d.com) — no API key pasting. This build's MCP endpoint is
China-only; overseas-site accounts need the overseas Tripo 3D plugin build, or
the CLI with `--region ov`.
Connect your Tripo mainland China account (developers.tripo3d.com) once in
the browser, without pasting an API key into the chat.

## Components

| Component | What it does |
| --- | --- |
| Skill `tripo-3d` | Main workflow: execution-path selection, authorization guidance, MCP workflow, scenario → tool-chain mapping, input handling, credit rules; plus the fallback `tripo-cli` path |
| Skill `tripo-3d` | Main workflow: tool check, authorization guidance, MCP workflow, scenario → tool-chain mapping, input handling, credit rules |
| Skill `tripo-game-asset` | Game-asset recipes: budgeted low-poly props, LOD chains, rigged characters with locomotion clips, wiring into Unity/Unreal/Godot/Three.js |
| MCP server `tripo` | Remote Streamable HTTP server `https://developers.tripo3d.com/mcp` (OAuth 2.1) exposing 26 tools such as `tripo_plan`, `tripo_text_to_3d`, `tripo_image_to_3d`, `tripo_task_wait`, `tripo_mesh_edit`, `tripo_rig`, `tripo_animate`, `tripo_convert` |
| Hook `SessionStart` | Injects five hard rules (async waiting, link expiry, credit confirmation / `tripo_plan`, browser authorization, honest failure reporting) so they hold even when no skill was triggered |
| MCP server `tripo` | China site: remote Streamable HTTP server `https://developers.tripo3d.com/mcp` (OAuth 2.1), including `tripo_plan`, generation, rigging, conversion and `tripo_smart_uv`; available tool schemas are authoritative |
| Hook `SessionStart` | Injects eight rules covering async waiting, short-lived links, credit confirmation, browser authorization, honest failures, PBR, model selection and concept-image confirmation |

## Usage

Expand All @@ -34,54 +57,64 @@ Install and enable the plugin, then just describe what you need, for example:
You can also type `/` in the composer and pick `tripo-3d` or `tripo-game-asset`
from the Skills group.

For a text-only model request, the skill first plans and asks you to confirm
the concept-image cost. It generates and shows the image, then waits for your
acceptance before planning and asking for separate confirmation of the 3D step
and any requested post-processing. You can explicitly ask to skip the image and
generate directly from text. An image or multiview set you already supplied can
be used directly for 3D generation.

### First-time authorization

The Tripo MCP server needs a one-time authorization:

1. Open **Settings → MCP**, find the Tripo row under "Plugin MCP servers"
(it shows "Authorization required") and click **Open authorization**.
2. The system browser opens the Tripo authorization page for the **China site**
(developers.tripo3d.com — +86 SMS sign-in, Alipay top-up). There is no
region picker on this page. You can sign up on the spot; new accounts get
free credits. An international-site account will not authorize against this
build — use the overseas plugin or `tripo-cli` with `--region ov`.
3. The page shows a one-time verification code and opens the Tripo console:
sign in, type the code into **Verification code**, click **Authorize**.
Authorize the Tripo China MCP server once:

1. Open **Settings → MCP Servers**. Under "Plugin MCP servers", find the
`tripo` row and click **Open authorization**.
2. The browser opens the **China site** authorization page
(developers.tripo3d.com, +86 SMS sign-in, Alipay top-up). The page has no
region picker. You can sign up on the spot.
3. The page shows a one-time verification code and opens the Tripo console.
Sign in, type the code into **Verification code**, and click **Authorize**.
4. ZCode reconnects and loads the tools automatically. To revoke access,
delete the API key you picked during authorization on the console's
API Keys page.

## Dependencies, network access and side effects

- **Network**: MCP tool calls go to `https://developers.tripo3d.com/mcp`;
authorization redirects to the China Tripo console
(developers.tripo3d.com). Results are downloaded from Tripo's CDN through
short-lived links (about 5 minutes).
authorization redirects to the Tripo China console (developers.tripo3d.com).
Results are available through short-lived Tripo CDN links.
`tripo_task_status` refreshes them when needed.
- **Account and billing**: every generation spends credits from your own
Tripo account; each tool reports `credits_consumed`, failed tasks are
refunded automatically. The skill drafts the chain with `tripo_plan`,
checks the balance and asks before generating a batch.
- **File writes**: only when you ask for the model on disk, the agent
Tripo account; use task status and the usage ledger for actual charges. Failed
tasks are refunded automatically. The skill drafts billed steps with
`tripo_plan` and asks for explicit confirmation before they run. For a batch,
it checks the balance and confirms the cost of each phase before that phase runs.
- **File writes**: when you ask to save or integrate a model, the agent
downloads it into your project with `curl`. The hook and the MCP server
write nothing.
- **Command execution**: on the MCP path, shell commands run only to upload a
local image/model (the `curl` returned by `tripo_upload_ticket`) or to
download a result. The fallback CLI path downloads and runs
[tripo-cli](https://www.npmjs.com/package/tripo-cli) (MIT, via
`npx tripo-cli@latest`), only for jobs that need it (e.g. bulk generation),
and says so first.
- **Command execution**: shell commands run only to upload a local image/model
(using the command returned by `tripo_upload_ticket` or, for larger files when
the connected server supports it, `tripo_upload_presign`) or to download a result. The
plugin never installs or runs a command-line client, including after an MCP
failure, missing authorization, batch work or a request to save files locally.
- **Hook**: `hooks/session-start.mjs` needs `node` on PATH. It reads the
event from stdin and prints a fixed text to stdout; no network, no file
access.
- **No data collection**: the plugin contains no telemetry; account
credentials are managed by ZCode's credential store and never pass through
the chat.
event from stdin and prints the rules to stdout; no network, no file access.
- **Telemetry**: the plugin has no independent analytics SDK. When enabled on
the deployed Tripo China MCP server, analytics can record tool results, task
metadata and the Tripo account ID when resolved. The plugin declares the
non-credential `X-Tripo-Distribution: zcode_plugin` header; if the host
forwards it, the server records the distribution channel separately from
the detected client (such as ZCode, Claude, or unknown). Analytics excludes
prompts, API keys, OAuth tokens, file paths and signed download links.
Account credentials are managed by ZCode's credential store and never pass
through the chat.

## Provenance and license

- Plugin: MIT, by [VAST](https://www.tripo3d.ai).
- Both skills are ported from Tripo's official Kimi / Codex plugins (also
maintained by VAST, MIT).
- The MCP server and `tripo-cli` are official Tripo implementations;
- The MCP server runs the official Tripo implementation;
generated content is subject to the
[Tripo API content policy](https://platform.tripo3d.ai/docs).
Loading
Loading