MCP server for Tripo3D AI 3D model generation API integration
Three tools with complete input schemas and descriptions, but significant gaps in output documentation, error guidance, and parameter constraints. Tool names follow verb_noun pattern (create_, get_, download_). Descriptions are present (60-90 chars) but lack actionable context for LLM selection. No enum constraints on task_type despite known valid values. Error handling returns structured responses but lacks recovery guidance. Output schemas are not documented, LLMs cannot plan downstream calls. No tool annotations (readOnlyHint/destructiveHint). Baseline: 549 production tools average 194 chars for descriptions; these average ~75 chars.
Create a Tripo3D task for 3D model generation from text, image, or multiview images
Download the output files from a completed Tripo3D task
Fetch the status and details of a Tripo3D task
Output schemas not documented. LLMs cannot infer what fields to expect from tool responses, blocking downstream tool chaining and data extraction.
task_type parameter lacks enum constraint. Valid values ('text_to_model', 'image_to_model', 'multiview_to_model') are hardcoded in implementation but not exposed to LLM. LLM may hallucinate invalid task types.
Error responses lack recovery guidance. skill_error() returns error messages but does not tell LLM what to do next (retry, call different tool, ask user). E.g., 'prompt is required' should suggest 'Provide a text description for text_to_model tasks.'
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 54 | 2026-07-28+ | v2 |
Descriptions too brief (50-90 chars vs. baseline 194 chars). Missing WHEN to use each tool and prerequisites. E.g., get_tripo3d_task description does not mention that task_id must come from create_tripo3d_task.
No tool annotations (readOnlyHint, destructiveHint, idempotentHint). create_tripo3d_task and download_tripo3d_task are destructive/write operations but lack destructiveHint. get_tripo3d_task is read-only but lacks readOnlyHint.