android_list_emulators

List available Android emulators to manage virtual devices for development and testing.

Instructions

List available Android emulators

Input Schema

TableJSON Schema

Name	Required	Description	Default
No arguments

Implementation Reference

src/tools/android.ts:509-534 (handler)

The main handler function for 'android_list_emulators' tool. Executes 'emulator -list-avds' to list available AVDs, parses the output, checks which are running using the global runningEmulators map, and returns structured data with emulator list, counts, and status.

handler: async () => {
  const result = await processExecutor.execute('emulator', ['-list-avds']);

  if (result.exitCode !== 0) {
    throw new Error(`Emulator listing failed: ${result.stderr}`);
  }

  const emulators = result.stdout
    .split('\n')
    .map(line => line.trim())
    .filter(line => line.length > 0)
    .map(name => ({
      name,
      isRunning: runningEmulators.has(name),
      pid: runningEmulators.get(name) || null,
    }));

  return {
    success: true,
    data: {
      emulators,
      totalCount: emulators.length,
      runningCount: emulators.filter(e => e.isRunning).length,
    },
  };
}

src/tools/android.ts:501-535 (registration)

Registration of the 'android_list_emulators' tool within the createAndroidTools factory function. Defines name, description, empty inputSchema (no parameters required), and attaches the handler.

tools.set('android_list_emulators', {
  name: 'android_list_emulators',
  description: 'List available Android emulators',
  inputSchema: {
    type: 'object',
    properties: {},
    required: []
  },
  handler: async () => {
    const result = await processExecutor.execute('emulator', ['-list-avds']);

    if (result.exitCode !== 0) {
      throw new Error(`Emulator listing failed: ${result.stderr}`);
    }

    const emulators = result.stdout
      .split('\n')
      .map(line => line.trim())
      .filter(line => line.length > 0)
      .map(name => ({
        name,
        isRunning: runningEmulators.has(name),
        pid: runningEmulators.get(name) || null,
      }));

    return {
      success: true,
      data: {
        emulators,
        totalCount: emulators.length,
        runningCount: emulators.filter(e => e.isRunning).length,
      },
    };
  }
});

src/tools/android.ts:42-47 (helper)
Global runningEmulators map used by the handler to determine if an emulator is running and its PID. Initialized and used within createAndroidTools.
```
 * Maps AVD names to process IDs.
 *
 * @type {Map<string, number>}
 */
let runningEmulators: Map<string, number>;
```

src/utils/tool-categories.ts:121-129 (registration)

Metadata registration in TOOL_REGISTRY for categorization, requirements (requires 'emulator' tool), performance expectations, and testing safety.

'android_list_emulators': {
  name: 'android_list_emulators',
  category: ToolCategory.ESSENTIAL,
  platform: 'android',
  requiredTools: [RequiredTool.EMULATOR],
  description: 'List available Android emulators',
  safeForTesting: true,
  performance: { expectedDuration: 1000, timeout: 15000 }
},

MCP Mobile Server