VAST-AI-Research/tripo-mcp

get_scene_info

Get detailed information about the current Blender scene

get_object_info

Get detailed information about a specific object in the Blender scene.

Parameters:

• object_name: The name of the object to get information about

create_object

Create a new object in the Blender scene.

Parameters:

• type: Object type (CUBE, SPHERE, CYLINDER, PLANE, CONE, TORUS, EMPTY, CAMERA, LIGHT)
• name: Optional name for the object
• location: Optional [x, y, z] location coordinates
• rotation: Optional [x, y, z] rotation in radians
• scale: Optional [x, y, z] scale factors

modify_object

Modify an existing object in the Blender scene.

Parameters:

• name: Name of the object to modify
• location: Optional [x, y, z] location coordinates
• rotation: Optional [x, y, z] rotation in radians
• scale: Optional [x, y, z] scale factors
• visible: Optional boolean to set visibility

delete_object

Delete an object from the Blender scene.

Parameters:

• name: Name of the object to delete

set_material

Set or create a material for an object.

Parameters:

• object_name: Name of the object to apply the material to
• material_name: Optional name of the material to use or create
• color: Optional [R, G, B] color values (0.0-1.0)

execute_blender_code

Execute arbitrary Python code in Blender.

Parameters:

• code: The Python code to execute

get_polyhaven_categories

Get a list of categories for a specific asset type on Polyhaven.

Parameters:

• asset_type: The type of asset to get categories for (hdris, textures, models, all)

search_polyhaven_assets

Search for assets on Polyhaven with optional filtering.

Parameters:

• asset_type: Type of assets to search for (hdris, textures, models, all)
• categories: Optional comma-separated list of categories to filter by

Returns a list of matching assets with basic information.

download_polyhaven_asset

Download and import a Polyhaven asset into Blender.

Parameters:

• asset_id: The ID of the asset to download
• asset_type: The type of asset (hdris, textures, models)
• resolution: The resolution to download (e.g., 1k, 2k, 4k)
• file_format: Optional file format (e.g., hdr, exr for HDRIs; jpg, png for textures; gltf, fbx for models)

Returns a message indicating success or failure.

set_texture

Apply a previously downloaded Polyhaven texture to an object.

Parameters:

• object_name: Name of the object to apply the texture to
• texture_id: ID of the Polyhaven texture to apply (must be downloaded first)

Returns a message indicating success or failure.

get_polyhaven_status

Check if PolyHaven integration is enabled in Blender. Returns a message indicating whether PolyHaven features are available.

create_3d_model_from_text

Create a 3D model from a text description using the Tripo API.

IMPORTANT: This tool initiates a 3D model generation task but does NOT wait for completion. After calling this tool, you MUST repeatedly call the get_task_status tool with the returned task_id until the task status is SUCCESS or a terminal error state.

Typical workflow:

1. Call create_3d_model_from_text to start the task
2. Get the task_id from the response
3. Call get_task_status with the task_id
4. If status is not SUCCESS, wait a moment and call get_task_status again
5. Repeat until status is SUCCESS or a terminal error state
6. When status is SUCCESS, use the pbr_model_url from the response

Args: describe_the_look_of_object: A detailed description of the object to generate. face_limit: The maximum number of faces in the model. auto_size: Whether to automatically size the model.

Returns: A dictionary containing the task ID and instructions for checking the status.

import_tripo_glb_model

Import a GLB model from URL into Blender scene

Parameters:

• glb_url: Download URL of the GLB model file

Returns: Result message of the import operation

get_task_status

Get the status of a 3D model generation task.

IMPORTANT: This tool checks the status of a task started by create_3d_model_from_text. You may need to call this tool MULTIPLE TIMES until the task completes.

Typical workflow:

1. Call this tool with the task_id from create_3d_model_from_text
2. Check the status in the response:
   • If status is SUCCESS, the task is complete and you can use the pbr_model_url
   • If status is FAILED, CANCELLED, BANNED, or EXPIRED, the task failed
   • If status is anything else, the task is still in progress
3. If the task is still in progress, wait a moment and call this tool again

Args: task_id: The ID of the task to check (obtained from create_3d_model_from_text).

Returns: A dictionary containing the task status and other information.