mass_get_property
Retrieve a specific property from multiple instances simultaneously using a structured query, simplifying data extraction in Roblox Studio environments.
Instructions
Get the same property from multiple instances at once
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| paths | Yes | Array of instance paths to read from | |
| propertyName | Yes | Name of the property to get |
Implementation Reference
- src/tools/index.ts:198-214 (handler)The core MCP tool handler for mass_get_property. Validates input parameters (paths array and propertyName), forwards the request to the Studio bridge via HTTP client to /api/mass-get-property, and returns an MCP-formatted response containing the JSON-stringified result.
async massGetProperty(paths: string[], propertyName: string) { if (!paths || paths.length === 0 || !propertyName) { throw new Error('Paths array and property name are required for mass_get_property'); } const response = await this.client.request('/api/mass-get-property', { paths, propertyName }); return { content: [ { type: 'text', text: JSON.stringify(response, null, 2) } ] }; } - src/index.ts:270-287 (schema)The input schema definition for the mass_get_property tool, provided in response to ListToolsRequest. Specifies required parameters: paths (string array) and propertyName (string).
name: 'mass_get_property', description: 'Get the same property from multiple instances at once', inputSchema: { type: 'object', properties: { paths: { type: 'array', items: { type: 'string' }, description: 'Array of instance paths to read from' }, propertyName: { type: 'string', description: 'Name of the property to get' } }, required: ['paths', 'propertyName'] } }, - src/index.ts:682-683 (registration)Registration of the mass_get_property tool in the MCP CallToolRequest handler. Dispatches tool calls to the RobloxStudioTools.massGetProperty method with extracted arguments.
case 'mass_get_property': return await this.tools.massGetProperty((args as any)?.paths as string[], (args as any)?.propertyName as string); - src/http-server.ts:231-238 (helper)HTTP proxy endpoint in the bridge server that exposes mass_get_property for direct calls from the Studio plugin, forwarding to the tools handler.
app.post('/mcp/mass_get_property', async (req, res) => { try { const result = await tools.massGetProperty(req.body.paths, req.body.propertyName); res.json(result); } catch (error) { res.status(500).json({ error: error instanceof Error ? error.message : 'Unknown error' }); } });