it2mcp

Instructions

Implementation Reference

• src/it2mcp/server.py:791-798 (handler)

  Primary MCP tool handler for 'app_activate'. Decorated with @mcp.tool(), this async function activates iTerm2 by calling app.async_activate() through the _run helper. Returns 'iTerm2 activated' on success.

  async def app_activate() -> str:
      """Activate iTerm2 (bring to front)."""
  
      async def _impl(connection: iterm2.Connection, app: iterm2.App) -> str:
          await app.async_activate()
          return "iTerm2 activated"
  
      return await _run(_impl)

• src/it2mcp/server.py:1271-1275 (handler)

  Batch operation handler '_b_app_activate' for use within the batch() tool. Directly calls app.async_activate() without the _run wrapper since the connection is already established.

  async def _b_app_activate(
      connection: iterm2.Connection, app: iterm2.App, **_: Any,
  ) -> str:
      await app.async_activate()
      return "iTerm2 activated"

• src/it2mcp/server.py:1387-1387 (registration)

  Registration of 'app_activate' in the batch operations dictionary, mapping the operation name to its handler function _b_app_activate.

  "app_activate": _b_app_activate,

• src/it2mcp/security.py:66-66 (schema)

  Security tier assignment for 'app_activate' tool, classified as Tier.INTERACT in the security configuration.

  "app_activate": Tier.INTERACT,