getObjects
Retrieve all 3D objects from a specified Spline scene to access and manage scene components for design workflows.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sceneId | Yes | Scene ID |
Implementation Reference
- src/tools/object-tools.js:16-38 (handler)The handler function for the 'getObjects' tool. It takes a sceneId, fetches objects using apiClient.getObjects, and returns a formatted MCP response with JSON stringified objects or an error.async ({ sceneId }) => { try { const objects = await apiClient.getObjects(sceneId); return { content: [ { type: 'text', text: JSON.stringify(objects, null, 2) } ] }; } catch (error) { return { content: [ { type: 'text', text: `Error retrieving objects: ${error.message}` } ], isError: true }; } }
- src/tools/object-tools.js:13-15 (schema)Input schema validation using Zod for the sceneId parameter required by the getObjects tool.{ sceneId: z.string().min(1).describe('Scene ID'), },
- src/tools/object-tools.js:11-39 (registration)Direct registration of the 'getObjects' tool using server.tool within the registerObjectTools function.server.tool( 'getObjects', { sceneId: z.string().min(1).describe('Scene ID'), }, async ({ sceneId }) => { try { const objects = await apiClient.getObjects(sceneId); return { content: [ { type: 'text', text: JSON.stringify(objects, null, 2) } ] }; } catch (error) { return { content: [ { type: 'text', text: `Error retrieving objects: ${error.message}` } ], isError: true }; } } );
- src/utils/api-client.js:63-65 (helper)Supporting API client helper method that performs the HTTP GET request to retrieve objects from the Spline.design API.async getObjects(sceneId) { return this.request('GET', `/scenes/${sceneId}/objects`); }
- src/index.js:88-88 (registration)Top-level registration call that invokes registerObjectTools on the MCP server instance, thereby registering the getObjects tool among others.registerObjectTools(server);