Skip to content

Platform support matrix in CLI/MCP: mark platform-specific commands #5

@rafiki270

Description

@rafiki270

Problem

Commands that only work on specific platforms are not marked as such in CLI help or MCP tool descriptions. LLMs discover platform limitations only after hitting PLATFORM_NOT_SUPPORTED errors.

Platform-specific commands with no marking:

Command iOS Android macOS
set-renderer / get-renderer - - macOS only
safari-auth iOS only - -
debug-screens iOS only - -
set/get-debug-overlay iOS only - -
set/get-tv-sync iOS only - -
set-geolocation error works -
set-request-interception error stub -
show-keyboard / hide-keyboard works works not supported

Inconsistent error behavior:

  • iOS returns PLATFORM_NOT_SUPPORTED for geolocation/interception
  • Android returns stub success responses for the same endpoints
  • Neither tells the LLM upfront that the command won't work

Proposal

  1. Add platforms field to MCP tool definitions: ["ios", "android", "macos"]
  2. Add --platform note to CLI help for restricted commands
  3. Include platform info in --llm-help output
  4. Android stubs should return PLATFORM_NOT_SUPPORTED like iOS (or both should return stub success — pick one, be consistent)
  5. get-capabilities response should be surfaced in discovery so LLMs can check before calling

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions