Charles MCP Server

Instructions

Implementation Reference

• charles_mcp/tools/live.py:61-78 (handler)

  The handler for the start_live_capture tool, which triggers the live service start method.

  async def start_live_capture(
      ctx: ToolContext,
      reset_session: bool = True,
      include_existing: bool = False,
      adopt_existing: bool = False,
  ) -> LiveCaptureStartResult:
      """Start or adopt a live capture session for incremental polling.
      Returns a capture_id required by all other live tools.
      Use adopt_existing=true to take over an ongoing Charles session without clearing it."""
      deps = get_tool_dependencies(ctx)
      try:
          return await deps.live_service.start(
              reset_session=reset_session,
              include_existing=include_existing,
              adopt_existing=adopt_existing,
          )
      except Exception as exc:
          raise ValueError(str(exc)) from exc