Roblox Studio MCP Server

Instructions

Implementation Reference

• src/tools/index.ts:126-139 (handler)

  Core handler function that validates input, requests class information from the Studio HTTP client, and formats the response as MCP content.

  async getClassInfo(className: string) {
    if (!className) {
      throw new Error('Class name is required for get_class_info');
    }
    const response = await this.client.request('/api/class-info', { className });
    return {
      content: [
        {
          type: 'text',
          text: JSON.stringify(response, null, 2)
        }
      ]
    };
  }

• src/index.ts:187-198 (schema)

  Tool schema definition including name, description, and input schema requiring 'className' string.

  name: 'get_class_info',
  description: 'Get available properties/methods for Roblox classes',
  inputSchema: {
    type: 'object',
    properties: {
      className: {
        type: 'string',
        description: 'Roblox class name'
      }
    },
    required: ['className']
  }

• src/index.ts:668-669 (registration)

  MCP tool dispatcher registration in the CallToolRequestHandler switch case, calling the handler.

  case 'get_class_info':
    return await this.tools.getClassInfo((args as any)?.className as string);

• src/http-server.ts:213-220 (registration)

  HTTP proxy endpoint registration for get_class_info tool calls.

  app.post('/mcp/get_class_info', async (req, res) => {
    try {
      const result = await tools.getClassInfo(req.body.className);
      res.json(result);
    } catch (error) {
      res.status(500).json({ error: error instanceof Error ? error.message : 'Unknown error' });
    }
  });