start_instance
Launch a virtual Ubuntu desktop on Scrapybara MCP to access the web, run code, or sandbox securely. Provides a real-time stream URL to monitor the active instance.
Instructions
Start a Scrapybara Ubuntu instance. Use it as a desktop sandbox to access the web or run code. Always present the stream URL to the user afterwards so they can watch the instance in real time.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Implementation Reference
- src/index.ts:116-144 (handler)The switch case handler for the 'start_instance' tool. It creates a new Scrapybara Ubuntu instance, starts its browser, optionally authenticates using AUTH_STATE_ID, retrieves the stream URL, and returns the instance details including the stream URL.case "start_instance": { const instance = await client.startUbuntu(); await instance.browser.start({ abortSignal: currentController.signal, }); if (process.env.AUTH_STATE_ID) { await instance.browser.authenticate( { authStateId: process.env.AUTH_STATE_ID, }, { abortSignal: currentController.signal } ); } const streamUrlResponse = await instance.getStreamUrl({ abortSignal: currentController.signal, }); const streamUrl = streamUrlResponse.streamUrl; return { content: [ { type: "text", text: JSON.stringify({ ...instance, streamUrl }, null, 2), } as TextContent, ], }; }
- src/index.ts:73-77 (registration)Tool registration in the ListToolsRequestHandler response, defining name, description, and input schema for 'start_instance'.name: "start_instance", description: "Start a Scrapybara Ubuntu instance. Use it as a desktop sandbox to access the web or run code. Always present the stream URL to the user afterwards so they can watch the instance in real time.", inputSchema: zodToJsonSchema(StartInstanceSchema), },
- src/schemas.ts:10-10 (schema)Zod schema for 'start_instance' tool input parameters (empty object, no required params).export const StartInstanceSchema = z.object({});